Temporal.ZonedDateTime.prototype.epochMilliseconds

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

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

Примеры

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

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

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

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

Вы можете создать объект Temporal.ZonedDateTime из значения epochMilliseconds, сначала сконструировав объект Temporal.Instant с помощью Temporal.Instant.fromEpochMilliseconds(), а затем преобразовав его в объект Temporal.ZonedDateTime с помощью Temporal.Instant.prototype.toZonedDateTimeISO():

const epochMilliseconds = 1627821296789;
const instant = Temporal.Instant.fromEpochMilliseconds(epochMilliseconds);
const zdt = instant.toZonedDateTimeISO("UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]

В качестве альтернативы используйте конструктор Temporal.ZonedDateTime(), но сначала преобразуйте миллисекунды в наносекунды:

const epochMilliseconds = 1627821296789;
const epochNanoseconds = BigInt(epochMilliseconds) * 1_000_000n;
const zdt = new Temporal.ZonedDateTime(epochNanoseconds, "UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]

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

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

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.epochNanoseconds