大网数据广告活动
Web 标准与前端开发

Date.prototype.toTemporalInstant()

· 52CE 我爱测

Date 实例的 **`toTemporalInstant()`** 方法返回一个新的 Temporal.Instant 对象,该对象的 Temporal/Instant/epochMilliseconds 值与当前日期的时间戳 相同。

Date 实例的 toTemporalInstant() 方法返回一个新的 Temporal.Instant 对象,该对象的 Temporal/Instant/epochMilliseconds 值与当前日期的时间戳 相同。

可以使用此方法将传统的 Date 值转换为 Temporal API 格式,然后根据需要进一步将其转换为其他 Temporal 类。

语法

toTemporalInstant()

参数

无。

返回值

一个新的 Temporal.Instant 对象,其 Temporal/Instant/epochMilliseconds 值与当前日期的时间戳相同。其的微秒和纳秒部分始终是 0。

异常

  • RangeError
    • : 如果日期无效(其时间戳为 NaN)则抛出此异常。

示例

使用 toTemporalInstant()

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.Instant
  • Temporal.ZonedDateTime
  • Temporal/Instant/fromEpochMilliseconds

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。