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.
- : One of the following:
Return value
A new Temporal.Instant object representing the instant in time specified by info.
Exceptions
- TypeError
- : Thrown if
infois not aTemporal.Instantinstance or a string.
- : Thrown if
- 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 ±10<sup>8</sup> days, or about ±273,972.6 years, from the Unix epoch.
- : Thrown in one of the following cases:
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(instant2.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(instant3.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
Browser compatibility
See also
- Temporal.Instant
- Temporal/Instant/fromEpochMilliseconds
- Temporal/Instant/fromEpochNanoseconds
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
