JavaScript Date setHours() 方法

JavaScript 的 Date setHours() 方法用於設定 Date 物件的“小時”部分。它允許根據給定的數值（範圍為 0 到 23）更新小時部分。此方法的返回值將是 Date 物件的更新時間戳，它反映了透過修改小時部分所做的更改。

此外，我們還可以修改日期物件的分鐘、秒和毫秒。它不會返回一個新的 Date 物件，而是更新它被呼叫的現有 Date 物件。

語法

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

setHours(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，則結果為下一秒的第一毫秒。

返回值

此方法返回時間戳（以毫秒為單位），該時間戳表示在設定指定的小時、分鐘、秒和毫秒後修改的 Date 物件。

示例 1

在下面的示例中，我們使用 JavaScript Date setHours() 方法將當前日期的“小時”設定為 20：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setHours(20); // Set the hours to 20

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

輸出

如果我們執行上述程式，小時將設定為 20，分鐘和秒將根據當地時間。

示例 2

在這裡，我們將“小時”設定為 (10)，“分鐘”設定為 (30)：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setHours(10, 30); // Set the hours to 10 and the minutes to 30

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

輸出

執行後，此程式返回一個具有提供的小時和分鐘的時間戳。秒將根據當地時間。

示例 3

在這裡，我們將“小時”設定為 (10)，“分鐘”設定為 (30)，“秒”設定為 (45)：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setHours(10, 30, 45); // Set the hours to 10, minutes to 30, and seconds to 45

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

輸出

它返回時間戳為“Wed Dec 27 2023 10:30:45 GMT+0530 (India Standard Time)”

示例 4

如果我們為 hoursValue 提供“-1”，此方法將返回前一天的最後一個小：時

<html>
<body>
<script>
   const currentDate = new Date('2023-11-20 15:00:00'); //November 20 2023
   currentDate.setHours(-1);

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

輸出

它返回時間戳為“Sun Nov 19 2023 23:00:00 GMT+0530 (India Standard Time)”

示例 5

如果我們將minutesValue設定為“60”，此方法將返回下一小時的第一分鐘。

<html>
<body>
<script>
   const currentDate = new Date('2023-11-20 15:00:00'); //November 20 2023
   currentDate.setHours(18, 60);

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

輸出

它返回一個時間戳記，例如“2023年11月20日星期一 19:00:00 GMT+0530 (印度標準時間)”。

示例6

如果我們將secondsValue設定為“60”，此方法將返回下一分鐘的第一秒。

<html>
<body>
<script>
   const currentDate = new Date('2023-11-20 15:00:00'); //November 20 2023
   currentDate.setHours(18, 30, 60);

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

輸出

它返回一個時間戳記，例如“2023年11月20日星期一 18:31:00 GMT+0530 (印度標準時間)”。

列印頁面