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 ermöglicht es Ihnen, Instanzen zu erstellen, indem Sie die zugrunde liegenden Daten direkt bereitstellen. Wie bei allen anderen Temporal-Klassen sollten Sie normalerweise Temporal.ZonedDateTime-Objekte mit der statischen Methode Temporal.ZonedDateTime.from() konstruieren, 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. Im Gegensatz zu allen anderen Temporal-APIs muss es ein gültiger Zeitzonenbezeichner (entweder benannt oder als Offset) sein und kann nicht eine Temporal.ZonedDateTime-Instanz oder ein Datum-Uhrzeit-String sein.
calendar Optional: Ein String, der der calendarId-Eigenschaft entspricht. Sehen Sie sich Intl.supportedValuesOf() für eine Liste der häufig unterstützten Kalendertypen an. Standard ist "iso8601".

Rückgabewert

Ein neues Temporal.ZonedDateTime-Objekt, das den spezifischen Zeitpunkt repräsentiert, der durch die Parameter angegeben wurde.

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 vom 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 # sec-temporal-zoneddatetime-constructor