Date.prototype.toDateString()

基线 广泛可用

此功能已得到良好验证,并在许多设备和浏览器版本上都能正常使用。它已在所有浏览器中可用,自 2015 年 7 月.

toDateString() 方法是 Date 实例的方法,它返回一个字符串,表示该日期在本地时区中的日期部分。

试一试

语法

js
toDateString()

参数

无。

返回值

表示给定日期的日期部分的字符串(有关格式,请参见描述)。如果日期是 无效,则返回 "Invalid Date"

描述

Date 实例引用时间轴上的某个特定点。toDateString() 会将该日期解释为本地时区,并以英语格式化日期部分。它始终使用以下格式,用空格分隔

  1. 星期名称的前三个字母
  2. 月份名称的前三个字母
  3. 两位数的月份日期,必要时在左侧填充零
  4. 四位数的年份(至少),必要时在左侧填充零。可能包含负号

例如: "Thu Jan 01 1970"。

  • 如果您只想获取时间部分,请使用 toTimeString()
  • 如果您想要获取日期和时间,请使用 toString()
  • 如果您希望将日期解释为 UTC 而不是本地时区,请使用 toUTCString()
  • 如果您希望以更友好的格式格式化日期(例如本地化),请使用 toLocaleDateString()

示例

使用 toDateString()

js
const d = new Date(0);

console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"
console.log(d.toDateString()); // "Thu Jan 01 1970"

规范

规范
ECMAScript 语言规范
# sec-date.prototype.todatestring

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅