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(year, month, day, hour, minute, second, millisecond);

参数

此方法接受七个参数。下面描述了这些参数:

  • yearValue 一个整数,表示新的一年(四位数字)。
  • month (可选) 一个介于 0 和 11 之间的整数,其中 0 是 1 月,11 是 12 月。
    • 如果提供 -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,则结果为下一秒的第一毫秒。

返回值

此方法返回根据 UTC 计算的指定日期和纪元(即 1970 年 1 月 1 日)之间的毫秒数。

示例 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() 创建 2023 年 1 月 15 日 12:30:00 UTC 的 Date 对象:

<html>
<body>
<script>
   const utcDate = new Date(Date.UTC(2023, 0, 15, 12, 30, 0));
   document.write(utcDate);
</script>
</body>
</html>

输出

生成的日期对象将以 UTC 格式返回。

广告