Temporal.ZonedDateTime.prototype.toInstant()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The toInstant() method of Temporal.ZonedDateTime instances returns a new Temporal.Instant object representing the instant of this date-time.

Syntax

js
toInstant()

Parameters

None.

Return value

A new Temporal.Instant object representing the instant of this date-time.

Examples

Using toInstant()

js
const zdt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56.987654321-04:00[America/New_York]",
);
const instant = zdt.toInstant();
console.log(instant.toString()); // 2021-07-01T16:34:56.987654321Z

Specifications

Specification
Temporal proposal
# sec-temporal.zoneddatetime.prototype.toinstant

Browser compatibility

BCD tables only load in the browser

See also