JavaScript Date setUTCSeconds() 方法

JavaScript 的 Date.setUTCSeconds() 方法用於根據協調世界時 (UTC) 設定 Date 物件的“秒”。此方法的返回值將是 Date 物件的更新時間戳，它反映了透過修改秒分量所做的更改。此外，我們還可以修改日期物件的“毫秒”。

UTC，也稱為協調世界時，是世界時間標準確定的時間。UTC 等同於格林尼治標準時間 (GMT)，確保全球時間測量的統一性。

語法

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

setUTCSeconds(secondsValue, millisecondsValue);

引數

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

secondsValue 表示秒數的整數 (0 到 59)。
- 如果提供 -1，則結果為前一分鐘的最後一秒。
- 如果提供 60，則結果為下一分鐘的第一秒。
millisecondsValue (可選) 表示毫秒數的整數 (0 到 999)。
- 如果提供 -1，則結果為前一秒的最後一毫秒。
- 如果提供 1000，則結果為下一秒的第一毫秒。

返回值

此方法返回生成的日期與 1970 年 1 月 1 日午夜協調世界時 (UTC) 之間的毫秒數。

示例 1

在下面的示例中，我們使用 JavaScript Date setUTCSeconds() 方法將“秒”設定為 30，根據 UTC 時間：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setUTCSeconds(30);

   document.write(currentDate));
</script>
</body>
</html>

輸出

如果我們執行上述程式，秒將設定為 30。

示例 2

如果我們為 secondsValue 提供“-1”，此方法將給出前一分鐘的最後一秒：

<html>
<body>
<script>
   const currentDate = new Date("2023-12-25 18:30:10");
   currentDate.setUTCSeconds(-1);

   document.write(currentDate.getUTCSeconds());
</script>
</body>
</html>

輸出

它將返回“59”作為前一分鐘 (29) 的最後一秒。

示例 3

如果我們為 secondsValue 提供“60”，此方法將給出下一分鐘的第一秒：

<html>
<body>
<script>
   const currentDate = new Date("2023-12-25 18:30:10");
   currentDate.setSeconds(60);

   document.write(currentDate.getUTCSeconds());
</script>
</body>
</html>

輸出

它將返回“0”作為前一分鐘 (31) 的最後一秒。

示例 4

在下面的示例中，我們正在設定日期物件的“毫秒”以及“秒”：

<html>
<body>
<script>
   const currentDate = new Date("2023-12-25 18:30:10");
   currentDate.setSeconds(35, 697);

   document.write("UTCSeconds: ", currentDate.getUTCSeconds(), "
","UTCMilliseconds: ", currentDate.getMilliseconds());
</script>
</body>
</html>

輸出

如果我們執行上述程式，秒將設定為“35”，毫秒設定為“697”。

示例 5

如果我們將 NaN 值作為引數傳遞給此函式，則日期將設定為“無效日期”，並且返回 NaN 作為結果：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setUTCSeconds("Hle");

   document.write(currentDate);
</script>
</body>
</html>

輸出

我們可以看到輸出，返回 NaN 作為輸出。

列印頁面