Temporal.Instant.prototype.toZonedDateTimeISO()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die toZonedDateTimeISO()-Methode von Temporal.Instant-Instanzen gibt ein neues Temporal.ZonedDateTime-Objekt zurück, das diesen Zeitpunkt 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. Bei einerTemporal.ZonedDateTime-Instanz wird deren Zeitzone verwendet. Bei einem String kann es sich um einen benannten Zeitzonen-Identifier, einen Offset-Zeitzonen-Identifier oder einen Datum-Uhrzeit-String mit einem Zeitzonen-Identifier oder Offset handeln (siehe time zones and offsets für weitere Informationen).
Rückgabewert
Ein neues Temporal.ZonedDateTime-Objekt, das diesen Zeitpunkt 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 |