Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date/Date below:

Date() æž„é€ å‡½æ•° - JavaScript

Baseline Widely available

Date() 构造函数可以创建一个 Date 实例或返回代表当前时间的字符串。

const date1 = new Date("December 17, 1995 03:24:00");
// Sun Dec 17 1995 03:24:00 GMT...

const date2 = new Date("1995-12-17T03:24:00");
// Sun Dec 17 1995 03:24:00 GMT...

console.log(date1 === date2);
// Expected output: false

console.log(date1 - date2);
// Expected output: 0

new Date()
new Date(value)
new Date(dateString)
new Date(dateObject)

new Date(year, monthIndex)
new Date(year, monthIndex, day)
new Date(year, monthIndex, day, hours)
new Date(year, monthIndex, day, hours, minutes)
new Date(year, monthIndex, day, hours, minutes, seconds)
new Date(year, monthIndex, day, hours, minutes, seconds, milliseconds)

Date()

备注： 调用 Date() 时可以使用或不使用 new，但是它们有不同的效果。参见返回值部分。

对于 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"

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4