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
js
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.
- A
Return value
A new Temporal.Instant
object representing the instant in time specified by info
.
Exceptions
TypeError
-
Thrown if
info
is not aTemporal.Instant
instance or a string. RangeError
-
Thrown in one of the following cases:
- The string is not a valid RFC 9557 string.
- The info is not in the representable range, which is ±108 days, or about ±273,972.6 years, from the Unix epoch.
Examples
Creating an instant from a string
js
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
js
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
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
from |
Legend
Tip: you can click/tap on a cell for more information.
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.