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

瀏覽器相容性

另見