Temporal.ZonedDateTime.prototype.offset
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die offset-Accessor-Eigenschaft von Temporal.ZonedDateTime-Instanzen gibt einen String zurück, der den Offset darstellt, der verwendet wird, um den internen Zeitpunkt zu interpretieren, in der Form ±HH:mm (oder ±HH:mm:ss.sssssssss mit so viel Präzision unterhalb der Minute, wie nötig). Dieser Offset ist garantiert gültig für den angegebenen Zeitpunkt und die Zeitzone zum Zeitpunkt der Konstruktion.
Der Set-Accessor von offset ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die with()-Methode, um ein neues Temporal.ZonedDateTime-Objekt mit dem gewünschten neuen Wert zu erstellen (was normalerweise auch das Datum/die Uhrzeit ändert), oder verwenden Sie die withTimeZone()-Methode, um ein neues Temporal.ZonedDateTime-Objekt in einer anderen Zeitzone zu erstellen.
Beispiele
Verwendung von offset
const dt = Temporal.ZonedDateTime.from(
"2021-07-01T12:00:00-07:00[America/Los_Angeles]",
);
console.log(dt.offset); // "-07:00"
const dt2 = Temporal.ZonedDateTime.from("2021-07-01T12:00:00-07[-07]");
console.log(dt2.offset); // "-07:00"
const dt3 = Temporal.ZonedDateTime.from(
"1900-01-01T00:00:00+00:09:21[Europe/Paris]",
);
console.log(dt3.offset); // "+00:09:21"
const dt4 = Temporal.ZonedDateTime.from("2021-07-01T12:00:00Z[Asia/Shanghai]");
console.log(dt4.offset); // "+08:00"
Ändern des Offsets
Wenn die lokale Zeit zufällig zwei gültige Offsets hat, wie etwa bei einer Sommerzeitumstellung, können Sie den Offset ändern, ohne etwas anderes zu ändern:
const zdt = Temporal.ZonedDateTime.from(
"2024-11-03T01:05:00-04:00[America/New_York]",
);
const newZDT = zdt.with({ offset: "-05:00" });
console.log(newZDT.toString()); // "2024-11-03T01:05:00-05:00[America/New_York]"
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-get-temporal.zoneddatetime.prototype.offset |