JavaScript Date.UTC() 方法



在 JavaScript 中,Date.UTC() 方法是 Date 对象的静态方法,它允许您根据协调世界时 (UTC) 值而不是本地时间创建日期对象。此方法接受 7 个参数,这些参数表示类似于 “Date” 构造函数的日期和时间组件,以及自 1970 年 1 月 1 日 00:00:00 UTC 以来指定日期和时间的毫秒数。

与采用本地时间参数的 Date() 构造函数不同,Date.UTC() 根据 UTC 值构造日期和时间。

语法

以下是 JavaScript Date.UTC() 方法的语法 -


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

参数

此方法接受 7 个参数。相同的描述如下 -

  • year 年整数表示新的一年(四位数字)。
  • month(可选)一个介于 0 和 11 之间的整数,其中 0 是 1 月,11 是 12 月。
    • 如果提供 -1,则会导致上一年的最后一个月。
    • 如果提供 12,则会导致明年的第一个月。
  • day(可选)表示小时(0 到 23)的整数。
    • 如果提供 -1,则会导致前一天的最后一小时。
    • 如果提供 24,则会导致第二天的第一个小时。
  • hour(可选)一个整数,表示分钟(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() 方法的所有参数。此程序返回以下日期和 epoch 之间的毫秒差 -


<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>

输出

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