1. 面向开发者的 Web 技术
  2. JavaScript
  3. JavaScript 参考
  4. JavaScript 标准内置对象
  5. Date
  6. Date.prototype.toTemporalInstant()

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

View in English Always switch to English

Date.prototype.toTemporalInstant()

有限可用

此特性不属于基线，因为它尚未在主流浏览器中得到支持。

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

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

规范

规范
Temporal
# sec-date.prototype.totemporalinstant

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题