Date.prototype.toTemporalInstant()

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

toTemporalInstant() 方法屬於 Date 例項,它會返回一個新的 Temporal.Instant 物件,該物件的 epochMilliseconds 值與此日期 時間戳 的值相同。

使用此方法可以將舊的 Date 值轉換為 Temporal API,然後根據需要進一步轉換為其他 Temporal 類。

語法

js
toTemporalInstant()

引數

無。

返回值

返回一個新的 Temporal.Instant 物件,其 epochMilliseconds 值與此日期的時間戳相同。其微秒和納秒部分始終為 0

異常

RangeError

如果日期 無效(時間戳為 NaN)則丟擲。

示例

使用 toTemporalInstant()

js
const legacyDate = new Date("2021-07-01T12:34:56.789Z");
const instant = legacyDate.toTemporalInstant();

// Further convert it to other objects
const zdt = instant.toZonedDateTimeISO("UTC");
const date = zdt.toPlainDate();
console.log(date.toString()); // 2021-07-01

規範

規範
Temporal
# sec-date.prototype.totemporalinstant

瀏覽器相容性

另見