JavaScript Date setUTCMinutes() 方法

在 JavaScript 中，Date.setUTCMinutes() 方法用於根據 UTC（協調世界時）時區設定 Date 物件的分鐘。此方法允許您調整日期的分鐘部分，而不影響日期的其他部分（例如小時、日、月或年）。

如果此方法的提供的引數為“NaN”，則日期將設定為“Invalid Date”，並返回“NaN”。

語法

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

setUTCMinutes(minutesValue, secondsValue, msValue)

引數

此方法接受三個引數。具體描述如下：

minutesValue − 一個介於 0 和 59 之間的整數，表示分鐘。
secondsValue (可選) − 一個表示秒值的整數 (0-59)。
msValue (可選) − 一個表示毫秒值的整數 (0-999)。

返回值

此方法返回 1970 年 1 月 1 日 00:00:00 UTC 與設定指定分鐘、秒和毫秒後的更新日期物件之間的毫秒數。

示例 1

在下面的示例中，我們使用 JavaScript Date.setUTCMinutes() 方法將“分鐘”值設定為“15”，根據 UTC 時間：

<html>
<body>
<script>
   let date = new Date();
   let result = date.setUTCMinutes(15);
   document.write(result);
</script>
</body>
</html>

輸出

執行上述程式後，它將返回紀元時間與更新後的日期物件之間的毫秒數。

示例 2

在這個示例中，我們將分鐘設定為特定值“15”：

<html>
<body>
<script>
   let date = new Date();
   date.setUTCMinutes(15);
   document.write(date);
</script>
</body>
</html>

輸出

如果我們執行上述程式，它將設定日期物件的分鐘（根據 UTC 時間）。

示例 3

在這裡，我們將當前 UTC 時間的分鐘增加“15”：

<html>
<body>
<script>
   let date = new Date();
   date.setUTCMinutes(date.getUTCMinutes() + 15);
   document.write(date);
</script>
</body>
</html>

輸出

執行上述程式後，它將返回分鐘增加 15 的更新日期。

示例 4

如果為 setUTCMinutes() 方法提供的引數為“NaN”，則日期將設定為“invalid date”，並將返回“NaN”作為結果：

<html>
<body>
<script>
   let date = new Date();
   date.setUTCMinutes(NaN);
   document.write(date, "<br>");
   document.write(date.getUTCMinutes());
</script>
</body>
</html>

輸出

如果我們執行上述程式，它將返回 NaN 作為結果。

列印頁面