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

Date.prototype.valueOf()

· 52CE 我爱测

Date 实例的 **`valueOf()`** 方法用于返回自纪元(即协调世界时 1970 年 1 月 1 日零点)以来的毫秒数。

Date 实例的 valueOf() 方法用于返回自纪元(即协调世界时 1970 年 1 月 1 日零点)以来的毫秒数。

JavaScript Demo: Date.prototype.valueOf()

const date1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));

console.log(date1.valueOf());
// 预期输出:823230245000

const date2 = new Date("02 Feb 1996 03:04:05 GMT");

console.log(date2.valueOf());
// 预期输出:823230245000

语法

valueOf()

参数

无。

返回值

一个数字,表示该日期的时间戳,单位为毫秒。如果该日期无效,则返回 NaN。

描述

valueOf() 方法是强制类型转换机制的一部分。由于 Date 拥有 [Symbol.toPrimitive]() 方法,当 Date 对象被隐式转换为数字时,该方法总是优先于 valueOf()。不过,Date.prototype[Symbol.toPrimitive]() 在内部仍会调用 this.valueOf()。

Date 对象重写了 Object/valueOf 方法(该方法来自 Object)。Date.prototype.valueOf() 返回该日期的时间戳,其功能上等同于 Date.prototype.getTime() 方法。

示例

使用 valueOf()

const d = new Date(0); // 1970-01-01T00:00:00.000Z
console.log(d.valueOf()); // 0

规范

浏览器兼容性

参见

  • Object.prototype.valueOf()
  • Date.prototype.getTime()

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

资料来源与适用范围

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

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

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