Temporal.ZonedDateTime.prototype.timeZoneId
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die timeZoneId Accessor-Eigenschaft von Temporal.ZonedDateTime Instanzen gibt eine Zeichenkette zurück, die den Zeitzonenbezeichner repräsentiert, der verwendet wird, um den internen Zeitpunkt zu interpretieren. Die Zeichenkette ist entweder ein benannter Bezeichner im bevorzugten Format (wie "America/New_York"), oder ein Offset in der Form "±hh:mm". Wenn die Zeitzone Aliasse hat, ist timeZoneId der Bezeichner, der verwendet wurde, um die ZonedDateTime zu erstellen, ohne eine Kanonisierung zum primären Bezeichner.
Der Set-Accessor von timeZoneId ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die Methode withTimeZone(), um ein neues Temporal.ZonedDateTime-Objekt mit dem gewünschten neuen Wert zu erstellen.
Hinweis:
Diese Zeichenkette ist nicht für die Anzeige an Benutzer vorgesehen. Verwenden Sie toLocaleString() mit den entsprechenden Optionen, um eine lokalisierte Zeichenkette 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 Bezeichner 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"
Darstellungsunterschiede werden jedoch 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 |