Temporal.Instant.prototype.toZonedDateTimeISO()

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 Methode toZonedDateTimeISO() von Temporal.Instant Instanzen gibt ein neues Temporal.ZonedDateTime Objekt zurück, das diesen Moment in der angegebenen Zeitzone unter Verwendung des ISO 8601 Kalendersystems darstellt.

Syntax

toZonedDateTimeISO(timeZone)

Parameter

timeZone: Entweder ein String oder eine Temporal.ZonedDateTime Instanz, die die zu verwendende Zeitzone darstellt. Wenn eine Temporal.ZonedDateTime Instanz, wird deren Zeitzone verwendet. Wenn ein String, kann es sich um einen benannten Zeitzonenbezeichner, einen Offset-Zeitzonenbezeichner oder einen Datums- und Zeit-String handeln, der einen Zeitzonenbezeichner oder einen Offset enthält (siehe Zeitzonen und Offsets für weitere Informationen).

Rückgabewert

Ein neues Temporal.ZonedDateTime Objekt, das diesen Moment in der angegebenen Zeitzone unter Verwendung des ISO 8601 Kalendersystems darstellt.

Ausnahmen

RangeError: Wird ausgelöst, wenn der Zeitzonenname ungültig ist.
TypeError: Wird ausgelöst, wenn timeZone weder ein String noch eine Temporal.ZonedDateTime Instanz ist.

Beispiele

Verwendung von toZonedDateTimeISO()

const instant = Temporal.Instant.from("2021-08-01T12:34:56.123456789Z");
const zonedDateTime = instant.toZonedDateTimeISO("America/New_York");
console.log(zonedDateTime.toString()); // 2021-08-01T08:34:56.123456789-04:00[America/New_York]

const localDateTime = instant.toZonedDateTimeISO(Temporal.Now.timeZoneId());
console.log(localDateTime.toString()); // This instant in your timezone

Spezifikationen

Specification
Temporal # sec-temporal.instant.prototype.tozoneddatetimeiso