Temporal.ZonedDateTime.prototype.getTimeZoneTransition()

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 getTimeZoneTransition() Methode von Temporal.ZonedDateTime Instanzen gibt ein Temporal.ZonedDateTime Objekt zurück, das den nächstgelegenen Zeitpunkt nach oder vor diesem Zeitpunkt darstellt, zu dem sich der UTC-Versatz der Zeitzone ändert (der zurückgegebene Zeitpunkt ist der erste Zeitpunkt nach der Änderung), oder null, wenn es keinen solchen Übergang gibt. Dies ist nützlich, um die Versatzregeln einer Zeitzone zu ermitteln, wie z.B. ihr Muster für die Sommerzeitumstellung.

Beachten Sie, dass die über die Zukunft zurückgegebenen Zeitpunkte möglicherweise unzuverlässig sind, beispielsweise aufgrund von Änderungen an den Zeitzonendefinitionen.

Syntax

getTimeZoneTransition(direction)
getTimeZoneTransition(options)

Parameter

direction

Ein String, der die direction Option darstellt. Dies ist eine Komfortüberladung, sodass getTimeZoneTransition(direction) äquivalent zu getTimeZoneTransition({ direction }) ist, wobei direction ein String ist.

options

Ein Objekt, das die folgende Eigenschaft enthält:

direction: Gibt an, ob vor oder nach dem aktuellen Zeitpunkt gesucht werden soll. Muss "next" oder "previous" sein.

Rückgabewert

Ein Temporal.ZonedDateTime Objekt mit dem Zeitpunkt t, sodass:

Der Zeitzonenversatz bei t unterscheidet sich von dem Versatz eine Nanosekunde vor t.
t < this.epochNanoseconds, wenn direction "previous" ist, oder t > this.epochNanoseconds, wenn direction "next" ist.
Für alle Zeitpunkte zwischen this.epochNanoseconds und t, exklusiv, ist der Versatz konstant.

Wenn es keinen solchen Übergang gibt, wird null zurückgegeben.

Beispiele

Finden des nächsten Zeitzonenübergangs

const dt = Temporal.ZonedDateTime.from("2024-01-01T00-05:00[America/New_York]");
const transition = dt.getTimeZoneTransition("next");
console.log(transition.toString()); // "2024-03-10T03:00:00-04:00[America/New_York]"

const transition2 = transition.getTimeZoneTransition("next");
console.log(transition2.toString()); // "2024-11-03T01:00:00-05:00[America/New_York]"

const transition3 = dt.getTimeZoneTransition("previous");
console.log(transition3.toString()); // "2023-11-05T01:00:00-05:00[America/New_York]"

const dt2 = Temporal.ZonedDateTime.from("2024-01-01T00Z[UTC]");
console.log(dt2.getTimeZoneTransition("next")); // null

Spezifikationen

Specification
Temporal # sec-temporal.zoneddatetime.prototype.gettimezonetransition