Temporal.ZonedDateTime.prototype.timeZoneId
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die timeZoneId Zugriffs-Eigenschaft von Temporal.ZonedDateTime Instanzen gibt einen String zurück, der den Zeitzonen-Identifikator darstellt, der verwendet wird, um den internen Zeitpunkt zu interpretieren. Der String ist entweder ein benannter Identifikator im bevorzugten Format (wie "America/New_York") oder ein Offset in der Form "±hh:mm". Wenn die Zeitzone Aliase hat, ist die timeZoneId der Identifikator, der zur Erstellung der ZonedDateTime verwendet wurde, ohne Kanonisierung zum primären Identifikator.
Der Set-Zugriff von timeZoneId ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die withTimeZone() Methode, um ein neues Temporal.ZonedDateTime Objekt mit dem gewünschten neuen Wert zu erstellen.
Hinweis:
Dieser String ist nicht für die Anzeige an Benutzer vorgesehen. Verwenden Sie toLocaleString() mit den entsprechenden Optionen, um einen lokalisierten String zu erhalten.
Beispiele
Verwendung von timeZoneId
const dt = Temporal.ZonedDateTime.from(
"2021-07-01T12:00:00-07:00[America/Los_Angeles]",
);
console.log(dt.timeZoneId); // "America/Los_Angeles"
const dt2 = Temporal.ZonedDateTime.from("2021-07-01T12:00:00-07:00[-07:00]");
console.log(dt2.timeZoneId); // "-07:00"
const dt3 = dt2.withTimeZone("Asia/Shanghai");
console.log(dt3.timeZoneId); // "Asia/Shanghai"
Die timeZoneId wird nie zum primären Identifikator kanonisiert; sie ist identisch mit derjenigen, die zur Erstellung der ZonedDateTime verwendet wurde.
const dt = Temporal.ZonedDateTime.from(
"2021-07-01T12:00:00+07:00[Asia/Ho_Chi_Minh]",
);
const dt2 = Temporal.ZonedDateTime.from(
"2021-07-01T12:00:00+07:00[Asia/Saigon]",
);
console.log(dt.timeZoneId); // "Asia/Ho_Chi_Minh"
console.log(dt2.timeZoneId); // "Asia/Saigon"
Allerdings werden darstellungsbezogene Unterschiede kanonisiert.
const dt = Temporal.ZonedDateTime.from(
"2021-07-01T12:00:00+07:00[asia/ho_chi_minh]",
);
console.log(dt.timeZoneId); // "Asia/Ho_Chi_Minh"
const dt2 = Temporal.ZonedDateTime.from("2021-07-01T12:00:00+07:00[+07]");
console.log(dt2.timeZoneId); // "+07:00"
Spezifikationen
| Specification |
|---|
| Temporal # sec-get-temporal.zoneddatetime.prototype.timezoneid |