JavaScript Date.UTC() 方法
在 JavaScript 中，Date.UTC() 方法是 Date 对象的静态方法，它允许您基于协调世界时 (UTC) 值(而非本地时间)创建日期对象。此方法接受七个参数，这些参数代表与"Date"构造函数类似的日期和时间组件，以及自 1970 年 1 月 1 日 00:00:00 UTC 以来指定日期和时间的毫秒数。
与接受本地时间参数的 Date() 构造函数不同，Date.UTC() 基于 UTC 值构建日期和时间。
语法
以下是 JavaScript Date.UTC() 方法的语法 -
Date.UTC(年, 月, 日, 时, 分, 秒, 毫秒);
参数
此方法接受七个参数。下文描述相同 -
- yearValue 一个表示新年的整数(四位数字)。
-
month (可选) 一个介于 0 到 11 之间的整数，其中 0 表示一月，11 表示十二月。
- 如果提供 -1，则结果为上一年的最后一个月。
- 如果提供 12，则结果为下一年的第一个月。
-
hour (可选) 一个表示小时的整数(0 到 23)。
- 如果提供 -1，则结果为前一天的最后一小时。
- 如果提供 24，则结果为第二天的第一个小时。
-
minute (可选) 一个表示分钟的整数(0 到 59)。如果不提供，分钟将被设置为 0。
- 如果提供 -1，则返回上一小时的最后一分钟。
- 如果提供 60，则返回下一小时的第一分钟。
-
second (可选) 一个表示秒的整数(0 到 59)。如果未提供，秒数将设置为 0。
- 如果提供 -1，则返回上一分钟的最后一秒。
- 如果提供 60，则返回下一分钟的第一秒。
-
millisecond (可选) 表示毫秒的整数(0 到 999)。如果未提供，毫秒数将设置为 0。
- 如果提供 -1，则返回前一秒的最后一毫秒。
- 如果提供 1000，则返回下一秒的第一毫秒。
返回值
此方法返回指定日期与纪元(例如 1970 年 1 月 1 日)之间的毫秒数(以 UTC 为准)。
示例 1
在下面的示例中，我们使用 JavaScript Date.UTC() 方法获取指定日期与纪元之间的毫秒数(以 UTC 为准)-
<html> <body> <script> const utcDate = Date.UTC(2024); document.write(utcDate); </script> </body> </html>
输出
上述程序返回"1704067200000"作为毫秒差。
示例 2
这里，我们向 UTC() 方法提供所有参数。该程序返回以下日期与纪元之间的毫秒差 -
<html> <body> <script> const utcDate = Date.UTC(2023, 1, 15, 12, 30, 0); document.write(utcDate); </script> </body> </html>
输出
上述程序返回"1676464200000"作为毫秒差。
示例 3
本示例使用 Date.UTC() 创建一个 Date 对象，表示 2023 年 1 月 15 日 12:30:00 UTC 时间。
<html> <body> <script> const utcDate = new Date(Date.UTC(2023, 0, 15, 12, 30, 0)); document.write(utcDate); </script> </body> </html>
输出
结果日期对象将以 UTC 格式返回。
