Temporal.ZonedDateTime.prototype.offset

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 offset Zugriffs-Eigenschaft von Temporal.ZonedDateTime Instanzen gibt einen String zurück, der den Offset darstellt, der verwendet wird, um das interne Instant zu interpretieren, in der Form ±HH:mm (oder ±HH:mm:ss.sssssssss mit so viel subminütiger Präzision wie nötig). Dieser Offset ist garantiert gültig für das gegebene Instant und die Zeitzone zum Zeitpunkt der Erstellung.

Der Set-Zugriff 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 (normalerweise auch unter Änderung des Datums/Zeit) zu erstellen, oder verwenden Sie die withTimeZone() Methode, um ein neues Temporal.ZonedDateTime Objekt in einer anderen Zeitzone zu erstellen.

Beispiele

Verwendung von offset

js
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 Ortszeit zufällig zwei gültige Offsets hat, wie z.B. bei einem Wechsel zur Sommerzeit, können Sie den Offset ändern, ohne etwas anderes zu verändern:

js
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

Specification
Temporal
# sec-get-temporal.zoneddatetime.prototype.offset

Browser-Kompatibilität

Siehe auch