Temporal.Instant.prototype.toZonedDateTimeISO()

Метод toZonedDateTimeISO() экземпляров Temporal.Instant возвращает новый объект Temporal.ZonedDateTime, представляющий этот момент времени в указанном часовом поясе с использованием календарной системы ISO 8601.

Синтаксис

toZonedDateTimeISO(timeZone)

Параметры

timeZone

Строка или экземпляр Temporal.ZonedDateTime, представляющий используемый часовой пояс. Если это экземпляр Temporal.ZonedDateTime, используется его часовой пояс. Если это строка, она может быть идентификатором именованного часового пояса, идентификатором часового пояса со смещением или строкой даты и времени, содержащей идентификатор часового пояса или смещение (см. часовые пояса и смещения для получения дополнительной информации).

Возвращаемое значение

Новый объект Temporal.ZonedDateTime, представляющий этот момент времени в указанном часовом поясе с использованием календарной системы ISO 8601.

Исключения

RangeError

Выбрасывается, если имя часового пояса недействительно.

TypeError

Выбрасывается, если timeZone не является строкой или экземпляром Temporal.ZonedDateTime.

Примеры

Использование 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

Спецификации

Совместимость с браузерами

См. также

• Temporal.Instant
• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.toInstant()