Конструктор Temporal.ZonedDateTime()

Базовый уровень Ограниченная доступность

Эта функция не является базовой, поскольку она не работает в некоторых из наиболее широко используемых браузеров.

Экспериментальный: Это экспериментальная технология
Внимательно проверьте таблицу совместимости браузеров перед использованием в производственной среде.

Конструктор Temporal.ZonedDateTime() создает объекты Temporal.ZonedDateTime.

Этот конструктор позволяет создавать экземпляры, напрямую предоставляя базовые данные. Как и все другие классы Temporal, вы обычно должны конструировать объекты Temporal.ZonedDateTime с помощью статического метода Temporal.ZonedDateTime.from(), который может обрабатывать различные типы входных данных.

Синтаксис

new Temporal.ZonedDateTime(epochNanoseconds, timeZone)
new Temporal.ZonedDateTime(epochNanoseconds, timeZone, calendar)

Примечание: Temporal.ZonedDateTime() можно конструировать только с помощью new. Попытка вызвать его без new приведет к возникновению TypeError.

Параметры

epochNanoseconds: Объект BigInt, соответствующий свойству epochNanoseconds.
timeZone: Строка, соответствующая свойству timeZoneId. В отличие от всех других API Temporal, это должен быть действительный идентификатор часового пояса (именованный или с смещением) как есть, и он не может быть экземпляром Temporal.ZonedDateTime или строкой даты-времени.
calendar Необязательно: Строка, соответствующая свойству calendarId. См. Intl.supportedValuesOf() для списка общеподдерживаемых типов календарей. По умолчанию используется "iso8601".

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

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

Исключения

TypeError

Выбрасывается, если timeZone или calendar не является строкой.

RangeError

Выбрасывается в одном из следующих случаев:

epochNanoseconds находится вне представимого диапазона, который составляет ±10⁸ дней, или примерно ±273 972,6 лет от Unix epoch.
timeZone не является допустимым идентификатором часового пояса.
calendar не является допустимым идентификатором календаря.

Примеры

Использование Temporal.ZonedDateTime()

const zdt = new Temporal.ZonedDateTime(0n, "America/New_York");
console.log(zdt.toString()); // '1969-12-31T19:00:00-05:00[America/New_York]'

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

Спецификация
Temporal # sec-temporal-zoneddatetime-constructor

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

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`ZonedDateTime`	Нет	Нет	139	Нет	preview	Нет	139	Нет	Нет	Нет	Нет	Нет	1.4.0	2.7	26.0.0

См. также

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal/ZonedDateTime/ZonedDateTime