Temporal.Instant.fromEpochMilliseconds()

可用性有限

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

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

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

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

语法

js
Temporal.Instant.fromEpochMilliseconds(epochMilliseconds)

参数

epochMilliseconds

一个表示自 Unix 纪元以来的毫秒数的数字。在内部,它会被转换为 BigInt 并乘以 1e6 以获得纳秒数。

返回值

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

异常

RangeError

在以下情况之一中抛出

  • epochMilliseconds 无法转换为 BigInt(例如,不是整数)。
  • epochMilliseconds 不在 可表示的范围内,该范围是自 Unix 纪元起的 ±108 天,或约 ±273,972.6 年。

示例

使用 Temporal.Instant.fromEpochMilliseconds()

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

规范

规范
Temporal
# sec-temporal.instant.fromepochmilliseconds

浏览器兼容性

另见