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

Syntax

js
toZonedDateTimeISO(timeZone)

Parameter

timeZone

Entweder ein String oder eine Temporal.ZonedDateTime-Instanz, die die zu verwendende Zeitzone darstellt. Wenn es sich um eine Temporal.ZonedDateTime-Instanz handelt, wird deren Zeitzone verwendet. Wenn es ein String ist, kann es sich um einen benannten Zeitzonenbezeichner, einen Offset-Zeitzonenbezeichner oder einen Datums-Zeit-String mit einem Zeitzonenbezeichner oder einem Offset handeln (siehe Zeitzonen und Offsets für mehr 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()

js
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 proposal
# sec-temporal.instant.prototype.tozoneddatetimeiso

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch