JavaScript Date setUTCHours() 方法

JavaScript 的 Date.setUTCHours() 方法用於根據協調世界時 (UTC) 設定 Date 物件的小時。此外，我們還可以設定分鐘、秒和毫秒（可選）。

UTC 代表協調世界時。它是世界各地用來調節時鐘和時間的首要時間標準。而印度標準時間 (IST) 是印度採用的時間，IST 和 UTC 的時差為 UTC+5:30（即 5 小時 30 分鐘）。

語法

以下是 JavaScript Date setUTCHours() 方法的語法：

setUTCHours(hoursValue, minutesValue, secondsValue, millisecondsValue);

引數

此方法接受四個引數。具體說明如下：

hoursValue 表示小時的整數 (0 到 23)。
- 如果提供 -1，則結果為前一天的最後一個小時候。
- 如果提供 24，則結果為下一天的第一個小時。
minutesValue (可選) 表示分鐘的整數 (0 到 59)。如果未提供，則分鐘將設定為 0。
- 如果提供 -1，則結果為前一小時的最後一分鐘。
- 如果提供 60，則結果為下一小時的第一分鐘。
secondsValue (可選) 表示秒的整數 (0 到 59)。如果未提供，則秒將設定為 0。
- 如果提供 -1，則結果為前一分鐘的最後一秒。
- 如果提供 60，則結果為下一分鐘的第一秒。
millisecondsValue (可選) 表示毫秒的整數 (0 到 999)。如果未提供，則毫秒將設定為 0。
- 如果提供 -1，則結果為前一秒的最後一毫秒。
- 如果提供 1000，則結果為下一秒的第一毫秒。

返回值

此方法返回 1970 年 1 月 1 日午夜與更新的日期和時間之間的毫秒數。

示例 1

在以下示例中，我們使用 JavaScript Date setUTCHours() 方法將小時設定為 10，根據 UTC 時間：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setUTCHours(10);

   document.write('Updated Date:  ', currentDate);
</script>
</body>
</html>

輸出

此程式返回比 10 小時 (UTC) 快 5 小時的時間。分鐘不會提前 30 分鐘，因為我們這裡沒有設定分鐘。

示例 2

在這裡，我們將小時設定為 12（根據 UTC），並使用 getUTCHours() 方法返回它：

<html>
<body>
<script>
   const currentDate = new Date("December 25, 2023, 10:15:00");
   currentDate.setUTCHours(12);

   document.write('Updated UTC hour:  ', currentDate.getUTCHours());
</script>
</body>
</html>

輸出

上述程式返回 12 作為小時。

示例 3

在這裡，我們為 Date 物件提供了一個具體的日期。然後，我們將小時設定為 15，根據 UTC 時間：

<html>
<body>
<script>
   const currentDate = new Date("December 25, 2023, 10:15:00");
   currentDate.setUTCHours(15); // Set the hours to 20 (According to UTC)

   document.write("Updated Date:  ", currentDate);
</script>
</body>
</html>

輸出

此程式返回比 15 小時 (UTC) 快 5 小時的時間。分鐘不會提前 30 分鐘，因為我們這裡沒有設定分鐘。

示例 4

在下面的示例中，我們將小時設定為 11，分鐘設定為 30，根據 UTC：

<html>
<body>
<script>
   const currentDate = new Date("December 25, 2023, 10:15:00");
   currentDate.setUTCHours(11, 30); // Set the hours to 11 and the minutes to 30 (According to UTC)

   document.write("Updated Date:  ", currentDate);
</script>
</body>
</html>

輸出

此程式返回比 11 小時 30 分鐘 (UTC) 快 5 小時 30 分鐘的時間。

示例 5

在這裡，我們根據 UTC 設定小時、分鐘和秒：

<html>
<body>
<script>
   const currentDate = new Date("December 25, 2023, 10:15:00");
   currentDate.setUTCHours(11, 20, 30); 

   document.write("Updated Date:  ", currentDate);
</script>
</body>
</html>

輸出

上述程式將返回“Mon Dec 25 2023 16:50:30 GMT+0530 (India Standard Time)”作為輸出。

列印頁面