Date() 构造函数

对于 Date() 构造函数，有五种基本的形式：

无参数

当没有提供参数时，新创建的 Date 对象代表当前的日期和时间。

时间或时间戳值

value

一个整数，代表自 UTC 1970 年 1 月 1 日 00:00:00（ECMAScript 纪元，与 UNIX 纪元相同）以来的毫秒数，忽略闰秒。请记住，大多数 UNIX 时间戳函数只精确到最近的秒。

日期字符串

dateString

一个代表日期的字符串值，其格式由 Date.parse() 方法所识别。（ECMA262 规范规定了 ISO 8601 的简化版本，但其他格式可以由实现者定义，通常包括符合 IETF 的 RFC 2822 时间戳。）

备注： 当用 Date 构造函数（和 Date.parse，它们是等价的）解析日期字符串时，一定要确保输入符合 ISO 8601 格式（YYYY-MM-DDTHH:mm:ss.ssZ），其他格式的解析行为是实现定义的，可能无法在所有浏览器上运行。对 RFC 2822 格式字符串的支持只是惯例。如果要适应许多不同的格式，库可以提供帮助。

仅有日期的字符串（例如 "1970-01-01"）被视为 UTC，而日期时间的字符串（例如 "1970-01-01T12:00"）被视为本地时间。因此，我们也建议你确保这两种类型的输入格式是一致的。

日期对象

dateObject

一个现有的 Date 对象。这实际上是在现有的 Date 对象上复制了一个相同的日期和时间。这等同于 new Date(dateObject.valueOf())，除了不调用 valueOf() 方法。

当一个参数被传递给 Date() 构造函数时，Date 实例被特别处理。所有其他的值都被转换为原始值。如果结果是一个字符串，它将被解析为一个日期字符串。否则，产生的会被进一步强制转换为数值，并被视为时间戳。

日期和时间组件的单独值

给出至少一个年份和月份，这种形式的 Date() 返回一个 Date 对象，其组成部分的值（年、月、日、小时、分钟、秒和毫秒）都来自以下参数。任何缺失的字段都被赋予可能的最低值（day 为 1，其他所有组件为 0）。这些参数值都是根据当地的时区，而不是 UTC 来评估的。

如果任何参数超过其定义的范围，会发生“进位”。例如，如果传入一个大于 11 的 monthIndex，这些月将导致年的递增；如果传入一个大于 59 的 minutes，hours 将相应递增，等等。因此，new Date(1990, 12, 1) 将返回 1991 年 1 月 1 日；new Date(2020, 5, 19, 25, 65) 将返回 2020 年 6 月 20 日凌晨 2:05。

类似的，如果任何参数不足其定义的范围，会从高位“借位”。例如，new Date(2020, 5, 0) 将返回 2020 年 5 月 31 日。

year

表示年的整数。从 0 到 99 的值映射了 1900 到 1999 年。其他值对应真实的年份。参见示例。

monthIndex

表示月份的整数，从代表一月的 0 开始到代表十二月的 11 结束。

day 可选

表示一个月中第几天的整数。默认为 1。

hours 可选

表示一天中的小时数的整数值，在 0 到 23 之间。默认值为 0。

minutes 可选

表示时间的分钟段的整数值。默认为小时后的 0 分钟。

seconds 可选

表示时间的秒数段的整数值。默认为分钟后的 0 秒。

milliseconds 可选

表示时间的毫秒段的整数值。默认为 0 毫秒的秒数。

调用 new Date()（Date() 构造函数）会返回一个 Date 对象。如果调用无效的日期字符串，或者如果要构建的日期的 UNIX 时间戳小于 -8,640,000,000,000 或大于 8,640,000,000,000 毫秒，它会返回一个 Date 对象，其 toString() 方法返回字面量字符串 Invalid Date。

调用 Date() 函数（没有 new 关键字）会返回当前日期和时间的字符串表示，就像 new Date().toString() 那样。调用 Date() 函数（没有 new 关键字）时给出的任何参数都会被忽略；无论调用的是一个无效的日期字符串，甚至使用任何任意对象或其他原始值作为参数，它总是返回一个当前日期和时间的字符串表示。

以下示例展示了创建 JavaScript 日期的若干方法：

const today = new Date();
const birthday = new Date("December 17, 1995 03:24:00"); // 不被鼓励，可能不会在所有运行时环境起作用
const birthday = new Date("1995-12-17T03:24:00"); // 这是符合 ISO-8601 标准的，将可靠地工作
const birthday = new Date(1995, 11, 17); // 月份是以 0 为索引的
const birthday = new Date(1995, 11, 17, 3, 24, 0);
const birthday = new Date(628021800000); // 传递纪元时间戳参数

如果 Date() 构造函数被调用时有一个参数不是 Date 实例，它将被强制转换为原始值，然后检查它是否是一个字符串。例如，new Date(undefined) 与 new Date() 是不同的：

console.log(new Date(undefined)); // Invalid Date

这是因为 undefined 已经是一个原始类型值，但不是一个字符串，所以它将被强制转换为一个数值，也就是 NaN，因此不是一个有效的时间戳。另一方面，null 将被强制转换为 0。

console.log(new Date(null)); // 1970-01-01T00:00:00.000Z

数组将通过 Array.prototype.toString() 转换为字符串，它用逗号连接各元素。然而，任何有一个以上元素的数组所产生的字符串都不是有效的 ISO 8601 日期字符串，所以它的解析行为将由实现定义。不要将数组传递给 Date() 构造函数。

console.log(new Date(["2020-06-19", "17:13"]));
// Chrome 中会显示 2020-06-19T17:13:00.000Z，因为它可以识别 "2020-06-19,17:13" 这种形式
// Firefox 中会显示 "Invalid Date"

• Date