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 |
瀏覽器相容性
載入中…