Date.UTC()

¥Syntax

Date.UTC(year)
Date.UTC(year, monthIndex)
Date.UTC(year, monthIndex, day)
Date.UTC(year, monthIndex, day, hour)
Date.UTC(year, monthIndex, day, hour, minute)
Date.UTC(year, monthIndex, day, hour, minute, second)
Date.UTC(year, monthIndex, day, hour, minute, second, millisecond)

¥Parameters

year

代表年份的整数值。0 到 99 的值映射到 1900 到 1999 年。所有其他值均为实际年份。参见 example。

monthIndex Optional

代表月份的整数值，从 0 开始（一月）到 11（十二月）。默认为 0。

day Optional

代表月份中的某天的整数值。默认为 1。

hours Optional

: 0 和 23 之间的整数值，代表一天中的小时。默认为 0。

minutes Optional

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

seconds Optional

代表时间第二段的整数值。默认为 0。

milliseconds Optional

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

¥Return value

代表给定日期的 timestamp 的数字。如果日期是 invalid，则返回 NaN。

¥A number representing the timestamp of the given date. Returns NaN if the date is invalid.

¥Description

0 和 99 之间的年份转换为 20 世纪 (1900 + year) 中的年份。例如，95 转换为年份 1995。

¥Years between 0 and 99 are converted to a year in the 20th century (1900 + year). For example, 95 is converted to the year 1995.

UTC() 方法与 Date() 构造函数在三个方面有所不同：

¥The UTC() method differs from the Date() constructor in three ways:

1. Date.UTC() 使用世界时间而不是当地时间。
2. Date.UTC() 以数字形式返回时间值，而不是创建 Date 对象。
3. 当传递单个数字时，Date.UTC() 将其解释为年份而不是时间戳。

如果参数超出预期范围，UTC() 方法将更新其他参数以适应该值。例如，如果 15 用于 monthIndex，年份将增加 1 (year + 1)，月份将使用 3。

¥If a parameter is outside of the expected range, the UTC() method updates the other parameters to accommodate the value. For example, if 15 is used for monthIndex, the year will be incremented by 1 (year + 1) and 3 will be used for the month.

因为 UTC() 是 Date 的静态方法，所以你始终将其用作 Date.UTC()，而不是用作你创建的 Date 对象的方法。

¥Because UTC() is a static method of Date, you always use it as Date.UTC(), rather than as a method of a Date object you created.

¥Examples

¥Using Date.UTC()

以下语句创建一个 Date 对象，其参数被视为 UTC 而不是本地：

¥The following statement creates a Date object with the arguments treated as UTC instead of local:

const utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

¥Behavior of Date.UTC() with one argument

Date.UTC() 在传递一个参数时过去常常具有不一致的行为，因为实现仅使行为与 Date() 构造函数保持一致，而 Date() 构造函数不会将单个参数解释为年份数字。现在需要实现将省略的 monthIndex 视为 0，而不是将其强制为 NaN。

¥Date.UTC() when passed one argument used to have inconsistent behavior, because implementations only kept the behavior consistent with the Date() constructor, which does not interpret a single argument as the year number. Implementations are now required to treat omitted monthIndex as 0, instead of coercing it to NaN.

Date.UTC(2017); // 1483228800000

¥See also

• Date.parse()
• Date