Temporal.Instant.from()

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 Temporal.Instant.from() static method creates a new Temporal.Instant object from another Temporal.Instant object, or an RFC 9557 string.

Syntax

Temporal.Instant.from(info)

Parameters

info

One of the following:

A Temporal.Instant instance, which creates a copy of the instance.
An RFC 9557 string containing a date, time, and time zone offset. The time zone name is ignored; only the offset is used.

Return value

A new Temporal.Instant object representing the instant in time specified by info.

Exceptions

TypeError: Thrown if info is not a Temporal.Instant instance or a string.
RangeError: Thrown if the string is not a valid RFC 9557 string, or if the date and time are outside the range of representable instants (±10⁸ days, or about ±273,972.6 years).

Examples

Creating an instant from a string

const instant = Temporal.Instant.from("1970-01-01T00Z");
console.log(instant.toString()); // 1970-01-01T00:00:00Z

const instant2 = Temporal.Instant.from("1970-01-01T00+08:00");
console.log(instant.toString()); // 1969-12-31T16:00:00Z

// America/New_York is UTC-5 in January 1970, not UTC+8
const instant3 = Temporal.Instant.from("1970-01-01T00+08:00[America/New_York]");
console.log(instant.toString()); // 1969-12-31T16:00:00Z; the time zone name is ignored

Creating an instant from another instant

const instant = Temporal.Instant.from("1970-01-01T00Z");
const instant2 = Temporal.Instant.from(instant);
console.log(instant2.toString()); // 1970-01-01T00:00:00Z

Specifications

Specification
Temporal proposal # sec-temporal.instant.from

Browser compatibility

	Desktop					Mobile						Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	Deno	Node.js
`from`	No	No	No	No	preview	No	No	No	No	No	No	1.40	No