Date.prototype.toTemporalInstant() - JavaScript | MDN

Syntax

Parameters

None.

Return value

A new Temporal.Instant object with the same epochMilliseconds value as this date's timestamp. Its microsecond and nanosecond components are always 0.

Exceptions

RangeError

Thrown if the date is invalid (it has a timestamp of NaN).

Examples

Using toTemporalInstant()

js

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

Specifications

Specification
Temporal
# sec-date.prototype.totemporalinstant

Browser compatibility

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.