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

浏览器兼容性

另见