Temporal.Now.zonedDateTimeISO()

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 statische Methode Temporal.Now.zonedDateTimeISO() gibt das aktuelle Datum und die aktuelle Uhrzeit als ein Temporal.ZonedDateTime-Objekt zurück, im ISO 8601 Kalender und der angegebenen Zeitzone.

Syntax

js
Temporal.Now.zonedDateTimeISO()
Temporal.Now.zonedDateTimeISO(timeZone)

Parameter

timeZone Optional

Entweder ein String oder eine Instanz von Temporal.ZonedDateTime, die die Zeitzone repräsentiert, in der die Systemzeit interpretiert wird. Handelt es sich um eine Temporal.ZonedDateTime-Instanz, wird ihre Zeitzone verwendet. Ist es ein String, kann es sich um einen benannten Zeitzonenbezeichner, einen Offset-Zeitzonenbezeichner oder einen Datum-Uhrzeit-String handeln, der einen Zeitzonenbezeichner oder einen Offset enthält (siehe Zeitzonen und Offsets für weitere Informationen).

Rückgabewert

Das aktuelle Datum und die aktuelle Uhrzeit in der angegebenen Zeitzone, als ein Temporal.ZonedDateTime-Objekt im ISO 8601 Kalender. Hat die gleiche Präzision wie Temporal.Now.instant().

Ausnahmen

RangeError

Wird ausgelöst, wenn die Zeitzone ungültig ist.

Beispiele

Verwendung von Temporal.Now.zonedDateTimeISO()

js
// The current date and time in the system's time zone
const dateTime = Temporal.Now.zonedDateTimeISO();
console.log(dateTime); // e.g.: 2021-10-01T06:12:34.567890123+03:00[Africa/Nairobi]

// The current date and time in the "America/New_York" time zone
const dateTimeInNewYork = Temporal.Now.zonedDateTimeISO("America/New_York");
console.log(dateTimeInNewYork); // e.g.: 2021-09-30T23:12:34.567890123-04:00[America/New_York]

Spezifikationen

Specification
Temporal
# sec-temporal.now.zoneddatetimeiso

Browser-Kompatibilität

Siehe auch