Date.parse()

试一试

// Standard date-time string format
const unixTimeZero = Date.parse("1970-01-01T00:00:00Z");
// Non-standard format resembling toUTCString()
const javaScriptRelease = Date.parse("04 Dec 1995 00:12:00 GMT");

console.log(unixTimeZero);
// Expected output: 0

console.log(javaScriptRelease);
// Expected output: 818035920000

语法

Date.parse(dateString)

参数

dateString

一个 日期时间字符串格式 的字符串。有关使用不同格式的注意事项，请参阅链接的参考文档。

返回值

一个表示给定日期的 时间戳 的数字。如果 dateString 解析为有效日期失败，则返回 NaN。

描述

此函数对于根据字符串值设置日期值非常有用，例如与 setTime() 方法结合使用。

parse() 可以处理的格式没有明确指定，但有几个 不变量。

• 必须支持 日期时间字符串格式（由 toISOString() 生成）。
• 如果 x 是任何毫秒数为零的 Date 对象，则 x.valueOf() 应等于以下任何一项：Date.parse(x.toString())、Date.parse(x.toUTCString())、Date.parse(x.toISOString())。这意味着由 toString() 和 toUTCString() 生成的格式也应该被支持。
• 规范不要求支持由 toLocaleString() 生成的格式。但是，主要引擎都尝试支持 toLocaleString("en-US") 格式。

其他格式是实现定义的，可能无法在所有浏览器中正常工作。如果需要处理许多不同的格式，库会很有帮助。事实上，Date.parse() 的不可靠性是引入 Temporal API 的动机之一。

由于 parse() 是 Date 的一个静态方法，您总是使用 Date.parse() 来调用它，而不是作为您创建的 Date 对象的方法。

示例

使用 Date.parse()

以下调用都返回 1546300800000。第一个调用将暗示 UTC 时间，因为它只包含日期；其他调用明确指定了 UTC 时区。

Date.parse("2019-01-01");
Date.parse("2019-01-01T00:00:00.000Z");
Date.parse("2019-01-01T00:00:00.000+00:00");

以下调用不指定时区，由于它同时包含日期和时间，因此将被设置为系统中本地时区的 2019-01-01 00:00:00。

Date.parse("2019-01-01T00:00:00");

toString() 和 toUTCString() 格式

除了标准的日期时间字符串格式外，还支持 toString() 和 toUTCString() 格式。

// toString() format
Date.parse("Thu Jan 01 1970 00:00:00 GMT-0500 (Eastern Standard Time)");
// 18000000 in all implementations in all timezones

// toUTCString() format
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");
// 0 in all implementations in all timezones

非标准日期字符串

当日期字符串为非标准时，实现通常会默认使用本地时区。为了保持一致性，我们将假定运行时使用 UTC 时区，并且除非另有说明，否则输出将随设备的时区而变化。本地时区的夏令时（DST）也会对此产生影响。

以下是一些非标准日期字符串的更多示例。浏览器在解析日期字符串时非常宽松，可能会忽略字符串中无法解析的任何部分。出于兼容性原因，浏览器经常互相复制行为，因此这些处理模式倾向于跨浏览器传播。如前所述，以下示例仅用于说明，远非详尽无遗。

规范

浏览器兼容性

另见

• Date.UTC()