Date.prototype.toTemporalInstant()

Метод toTemporalInstant() экземпляров Date возвращает новый объект Temporal.Instant с тем же значением epochMilliseconds, что и метка времени этой даты.

Используйте этот метод для преобразования устаревших значений Date в API Temporal, а затем для дальнейшего преобразования в другие классы Temporal по мере необходимости.

Синтаксис

toTemporalInstant()

Параметры

Нет.

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

Новый объект Temporal.Instant с тем же значением epochMilliseconds, что и метка времени этой даты. Его компоненты микросекунд и наносекунд всегда 0.

Исключения

RangeError

Выбрасывается, если дата недействительна (имеет метку времени NaN).

Примеры

Использование toTemporalInstant()

const legacyDate = new Date("2021-07-01T12:34:56.789Z");
const instant = legacyDate.toTemporalInstant();

// Further convert it to other objects
const zdt = instant.toZonedDateTimeISO("UTC");
const date = zdt.toPlainDate();
console.log(date.toString()); // 2021-07-01

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

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

См. также

• Temporal.Instant
• Temporal.ZonedDateTime
• Temporal.Instant.fromEpochMilliseconds()