Temporal.ZonedDateTime()

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.

Der Temporal.ZonedDateTime() Konstruktor erstellt Temporal.ZonedDateTime Objekte.

Dieser Konstruktor erlaubt es, Instanzen direkt durch Bereitstellung der zugrunde liegenden Daten zu erstellen. Wie bei allen anderen Temporal Klassen sollten Temporal.ZonedDateTime Objekte normalerweise mit der statischen Methode Temporal.ZonedDateTime.from() konstruiert werden, die eine Vielzahl von Eingabetypen verarbeiten kann.

Syntax

new Temporal.ZonedDateTime(epochNanoseconds, timeZone)
new Temporal.ZonedDateTime(epochNanoseconds, timeZone, calendar)

Note: Temporal.ZonedDateTime() kann nur mit new konstruiert werden. Der Versuch, es ohne new aufzurufen, führt zu einem TypeError.

Parameter

epochNanoseconds: Ein BigInt, das der epochNanoseconds Eigenschaft entspricht.
timeZone: Ein String, der der timeZoneId Eigenschaft entspricht. Anders als bei allen anderen Temporal APIs muss es sich um einen gültigen Zeitzonenbezeichner (entweder benannt oder als Offset) handeln und kann keine Temporal.ZonedDateTime Instanz oder ein Datums-Zeit-String sein.
calendar Optional: Ein String, der der calendarId Eigenschaft entspricht. Standard ist "iso8601".

Rückgabewert

Ein neues Temporal.ZonedDateTime Objekt, das den durch die Parameter angegebenen spezifischen Zeitpunkt darstellt.

Ausnahmen

TypeError

Wird ausgelöst, wenn timeZone oder calendar kein String ist.

RangeError

Wird in einem der folgenden Fälle ausgelöst:

epochNanoseconds liegt nicht im darstellbaren Bereich, der ±10⁸ Tage oder etwa ±273.972,6 Jahre ab dem Unix-Epoch umfasst.
timeZone ist kein gültiger Zeitzonenbezeichner.
calendar ist kein gültiger Kalenderbezeichner.

Beispiele

Verwendung von Temporal.ZonedDateTime()

const zdt = new Temporal.ZonedDateTime(0n, "America/New_York");
console.log(zdt.toString()); // '1969-12-31T19:00:00-05:00[America/New_York]'

Spezifikationen

Specification
Temporal proposal # sec-temporal-zoneddatetime-constructor