Temporal.Instant.prototype.epochNanoseconds

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

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

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

Примеры

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

const instant = Temporal.Instant.from("2021-08-01T12:34:56.789Z");
console.log(instant.epochNanoseconds); // 1627821296789000000n

const instant2 = Temporal.Instant.from("1969-08-01T12:34:56.789Z");
console.log(instant2.epochNanoseconds); // -13173903211000000n

Изменение epochNanoseconds

Это метод, который позволяет перемещаться на любое количество времени:

const instant = Temporal.Instant.from("2021-08-01T12:34:56.789Z");
const instant1hourLater = instant.add({ hours: 1 });
console.log(instant1hourLater.epochNanoseconds); // 1627824896789000000n

Если вы уже знаете изменение в наносекундах, вы также можете напрямую создать новый объект Temporal.Instant:

const instant = Temporal.Instant.from("2021-08-01T12:34:56.789Z");
const instant1hourLater = Temporal.Instant.fromEpochNanoseconds(
  instant.epochNanoseconds + 3600000000000n,
);
console.log(instant1hourLater.epochNanoseconds); // 1627824896789000000n

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

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

См. также

• Temporal.Instant
• Temporal.Instant.prototype.epochMilliseconds
• Temporal.Instant.fromEpochNanoseconds()