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

Syntax

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

Parameter

timeZone Optional

Entweder ein String oder eine Temporal.ZonedDateTime-Instanz, die die Zeitzone repräsentiert, in der die Systemzeit interpretiert werden soll. Handelt es sich um eine Temporal.ZonedDateTime-Instanz, wird deren Zeitzone verwendet. Wenn es ein String ist, kann es sich um einen benannten Zeitzonenbezeichner, einen Offset-Zeitzonenbezeichner oder einen Datum-Zeit-String mit einem Zeitzonenbezeichner oder einem Offset handeln (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 Kalender ISO 8601. Hat dieselbe 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 proposal
# sec-temporal.now.zoneddatetimeiso

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch