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 direkt die zugrunde liegenden Daten angeben. Wie bei allen anderen Temporal Klassen sollten Sie Temporal.ZonedDateTime Objekte normalerweise mit der Temporal.ZonedDateTime.from() statischen Methode konstruieren, die eine Vielzahl von Eingabetypen verarbeiten kann.
Syntax
new Temporal.ZonedDateTime(epochNanoseconds, timeZone)
new Temporal.ZonedDateTime(epochNanoseconds, timeZone, calendar)
Parameter
epochNanoseconds-
Ein BigInt, das der
epochNanosecondsEigenschaft entspricht. timeZone-
Eine Zeichenkette, die der
timeZoneIdEigenschaft entspricht. Anders als bei allen anderenTemporalAPIs muss es sich dabei um einen gültigen Zeitzonen-Identifier (entweder benannt oder offset) handeln, und es kann keineTemporal.ZonedDateTimeInstanz oder ein Datum-Uhrzeit-String sein. calendarOptional-
Eine Zeichenkette, die der
calendarIdEigenschaft entspricht. SieheIntl.supportedValuesOf()für eine Liste der häufig unterstützten Kalenderarten. Standardmäßig"iso8601".
Rückgabewert
Ein neues Temporal.ZonedDateTime Objekt, das den spezifischen Moment repräsentiert, der durch die Parameter angegeben wird.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
timeZoneodercalendarkeine Zeichenkette ist. RangeError-
Wird in einem der folgenden Fälle ausgelöst:
epochNanosecondsliegt nicht im darstellbaren Bereich, der ±108 Tage oder etwa ±273.972,6 Jahre vom Unix-Epoch umfasst.timeZoneist kein gültiger Zeitzonen-Identifier.calendarist kein gültiger Kalender-Identifier.
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 |
Browser-Kompatibilität
Loading…