Temporal.ZonedDateTime.prototype.getTimeZoneTransition()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die getTimeZoneTransition()-Methode von Temporal.ZonedDateTime-Instanzen gibt ein Temporal.ZonedDateTime-Objekt zurück, das den nächstliegenden Zeitpunkt nach oder vor diesem Zeitpunkt darstellt, an dem sich der UTC-Offset der Zeitzone ändert (der zurückgegebene Zeitpunkt ist der erste nach der Änderung), oder null, wenn es keinen solchen Übergang gibt. Dies ist nützlich, um die Offset-Regeln einer Zeitzone zu ermitteln, wie zum Beispiel ihr Muster für die Sommerzeit.
Beachten Sie, dass die für die Zukunft zurückgegebenen Zeitpunkte möglicherweise unzuverlässig sind, beispielsweise aufgrund von Änderungen in den Zeitzonendefinitionen.
Syntax
getTimeZoneTransition(direction)
getTimeZoneTransition(options)
Parameter
direction-
Ein String, der die
direction-Option darstellt. Dies ist eine komfortable Überladung, daher istgetTimeZoneTransition(direction)äquivalent zugetTimeZoneTransition({ direction }), wobeidirectionein 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 entweder
"next"oder"previous"sein.
Rückgabewert
Ein Temporal.ZonedDateTime-Objekt mit dem Zeitpunkt t, so dass:
- Der Zeitzonen-Offset bei
tunterscheidet sich von dem Offset eine Nanosekunde vort. t < this.epochNanoseconds, wenndirection"previous"ist, odert > this.epochNanoseconds, wenndirection"next"ist.- Für alle Zeitpunkte zwischen
this.epochNanosecondsundt, exklusiv, ist der Offset konstant.
Wenn es keinen solchen Übergang gibt, wird null zurückgegeben.
Beispiele
Die nächste Zeitzonenänderung finden
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 |