此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Date.prototype.toTemporalInstant()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Date 实例的 toTemporalInstant() 方法返回一个新的 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();

// 进一步将其转换为其他对象
const zdt = instant.toZonedDateTimeISO("UTC");
const date = zdt.toPlainDate();
console.log(date.toString()); // 2021-07-01

规范

Specification
Temporal
# sec-date.prototype.totemporalinstant

浏览器兼容性

参见