Temporal.Instant.fromEpochNanoseconds()

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

Temporal.Instant.fromEpochNanoseconds() 静态方法根据自 Unix 纪元(UTC 时间 1970 年 1 月 1 日午夜)以来的纳秒数创建一个新的 Temporal.Instant 对象。

要将 Date 对象转换为 Temporal.Instant 对象,请使用 Date.prototype.toTemporalInstant()

语法

js
Temporal.Instant.fromEpochNanoseconds(epochNanoseconds)

参数

epochNanoseconds

一个 BigInt,表示自 Unix 纪元以来的纳秒数。

返回值

一个表示 epochNanoseconds 指定的时间点的新的 Temporal.Instant 对象。

异常

RangeError

如果 epochNanoseconds 不在 可表示的范围内(即自 Unix 纪元起 ±108 天,约 ±273,972.6 年),则会抛出此错误。

示例

使用 Temporal.Instant.fromEpochNanoseconds()

js
const instant = Temporal.Instant.fromEpochNanoseconds(0n);
console.log(instant.toString()); // 1970-01-01T00:00:00Z
const vostok1Liftoff =
  Temporal.Instant.fromEpochNanoseconds(-275248380000000000n);
console.log(vostok1Liftoff.toString()); // 1961-04-12T06:07:00Z
const sts1Liftoff = Temporal.Instant.fromEpochNanoseconds(355924804000000000n);
console.log(sts1Liftoff.toString()); // 1981-04-12T12:00:04Z

规范

规范
Temporal
# sec-temporal.instant.fromepochnanoseconds

浏览器兼容性

另见