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 dieses Instant im angegebenen Zeitzonenkontext 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 es sich um eineTemporal.ZonedDateTime-Instanz handelt, 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 Offset handeln (siehe Zeitzonen und Offsets für weitere Informationen).
Rückgabewert
Ein neues Temporal.ZonedDateTime-Objekt, das dieses Instant 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
timeZoneweder ein String noch eineTemporal.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 |
Browser-Kompatibilität
Loading…