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
directionOption darstellt. Dies ist eine Komfortüberladung, sodassgetTimeZoneTransition(direction)äquivalent zugetTimeZoneTransition({ direction })ist, 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
"next"oder"previous"sein.
Rückgabewert
Ein Temporal.ZonedDateTime Objekt mit dem Zeitpunkt t, sodass:
- Der Zeitzonenversatz bei
tunterscheidet sich von dem Versatz 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 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 |
Browser-Kompatibilität
Loading…