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 格式返回。

廣告