Spec-Zone.ru › JavaScript

Temporal.ZonedDateTime.prototype.epochNanoseconds

Baseline Ограниченная доступность

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

Свойство доступа epochNanoseconds экземпляров Temporal.ZonedDateTime возвращает BigInt, представляющий количество наносекунд, прошедших с начала эпохи Unix (полночь 1 января 1970 года, UTC) до этого момента.

Сеттер epochNanoseconds является undefined. Вы не можете изменить это свойство напрямую. Чтобы создать новый объект Temporal.ZonedDateTime с желаемым новым значением epochNanoseconds, вместо этого используйте конструктор new Temporal.ZonedDateTime().

Мгновение может представлять только ±108 дней (около ±273 972,6 лет) вокруг эпохи, что составляет ±8,64e21 наносекунд. Попытка установить epochNanoseconds за пределами этой границы вызовет RangeError.

Примеры

Использование epochNanoseconds

const zdt = Temporal.ZonedDateTime.from("2021-08-01T12:34:56.789Z[UTC]");
console.log(zdt.epochNanoseconds); // 1627821296789000000n

const zdt2 = Temporal.ZonedDateTime.from("1969-08-01T12:34:56.789Z[UTC]");
console.log(zdt2.epochNanoseconds); // -13173903211000000n

Создание объекта ZonedDateTime из значения epochNanoseconds

Вы можете создать объект Temporal.ZonedDateTime из значения epochNanoseconds, используя конструктор Temporal.ZonedDateTime().

const epochNanoseconds = 1627821296789000000n;
const zdt = new Temporal.ZonedDateTime(epochNanoseconds, "UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]

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

Спецификация
Temporal
# sec-get-temporal.zoneddatetime.prototype.epochnanoseconds

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

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
epochNanoseconds
144
144
139
128
preview
144
139
95
No
No
144
No
1.4.0
2.7
26.0.0

См. также

  • Temporal.ZonedDateTime
  • Temporal.ZonedDateTime.prototype.epochMilliseconds

© 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/epochNanoseconds

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API