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

Date.prototype[Symbol.toPrimitive]

· 52CE 我爱测

Date 实例的 **`Symbol.toPrimitive`** 方法返回表示当前日期的原始值。根据给定提示的不同,其可能是字符串或数字。

Date 实例的 [Symbol.toPrimitive]() 方法返回表示当前日期的原始值。根据给定提示的不同,其可能是字符串或数字。

JavaScript Demo: Date.prototype[Symbol.toPrimitive]

// Depending on timezone, your results will vary
const date = new Date("20 December 2019 14:48");

console.log(date[Symbol.toPrimitive]("string"));
// Expected output: "Fri Dec 20 2019 14:48:00 GMT+0530 (India Standard Time)"

console.log(date[Symbol.toPrimitive]("number"));
// Expected output: 1576833480000

语法

date[Symbol.toPrimitive](hint)

返回值

给出的 Date 的原始值。根据传入参数的不同,可以返回 string 或 number 类型。

说明

Date 对象的 [Symbol.toPrimitive]() 方法可以返回一个原始值,或是 string,或是 number。

如果 hint 是 "string" 或 "default",[Symbol.toPrimitive]() 将会调用 Object.prototype.toString()。如果 toString 属性不存在,则调用 Object.prototype.valueOf()。如果 valueOf 也不存在,则抛出一个TypeError。

如果 hint 是 "number",[Symbol.toPrimitive]() 会首先尝试 valueOf,若失败再尝试 toString。

当期望一个原始值却收到一个对象时,JavaScript 可以自动的调用 [Symbol.toPrimitive]() 方法来将一个对象转化成原始值,所以你很少会需要自己调用这个方法。

规范

浏览器兼容性

参见

  • Symbol.toPrimitive

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

资料来源与适用范围

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

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

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