JavaScript Date setUTCMonth() 方法

JavaScript 的 Date.setUTCMonth() 方法是 Date 物件的一個方法，它允許您根據協調世界時 (UTC) 設定日期的月份。此方法的返回值是 Date 物件的更新時間戳，它反映了透過修改月份所做的更改。可選地，我們還可以修改日期物件的日期值。如果 Date 物件的日期無效，則此方法返回“NaN”作為結果。

語法

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

setUTCMonth(monthValue, dateValue);

引數

此方法接受兩個引數。如下所述：

monthValue - 一個介於 0 和 11 之間的整數，其中 0 表示 1 月，11 表示 12 月。
- 如果提供 -1，則將導致前一年的最後一個月。
- 如果提供 12，則將導致下一年的第一個月。
dateValue (可選) - 一個介於 1 和 31 之間的整數。
- 如果提供 0，則將導致前一個月的最後一天。
- 如果提供 -1，則將導致前一個月的倒數第二天。
- 如果提供 32，則將導致下一個月的第一天（如果該月有 31 天）。
- 如果提供 32，則將導致下一個月的第二天（如果該月有 30 天）。

返回值

此方法返回表示修改月份和日期（可選）後的新日期的時間戳。

示例 1

在以下示例中，我們使用 JavaScript Date setUTCMonth() 方法將 Date 物件的“月份”設定為 10（11 月）(UTC)：

<html>
<body>
<script>
   let date = new Date();
   date.setUTCMonth(10); // Sets the month to November

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

輸出

如果我們執行上述程式，則日期物件的月份將設定為 10。

示例 2

在這裡，我們已將月份設定為 10（11 月）並將日期設定為 (25)，根據 UTC：

<html>
<body>
<script>
   let date = new Date();
   date.setUTCMonth(10, 25); // Set month to November, and day to 25

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

輸出

執行後，此程式將返回一個使用提供的“月份”和“日期”值更新的時間戳。

示例 3

如果我們為 monthValue 提供“12”，則年份將增加 1 (yearValue + 1)，並且 0 將用於月份：

<html>
<body>
<script>
   const date = new Date('2022-11-15'); //December 15 2022
   date.setUTCMonth(12, 15); // It will be January 15 2023

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

輸出

上述程式返回的時間戳為“2023 年 1 月 15 日星期日 05:30:00 GMT+0530 (印度標準時間)”。

示例 4

如果我們為 dateValue 提供“32”，則月份將增加 1（如果該月有 31 天），並將導致下一個月的第一天。

<html>
<body>
   const date = new Date('2023-10-30'); //October 2023 has 31 days.
   date.setUTCMonth(9, 32); //It will be November 1 2023.

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

輸出

上述程式返回的時間戳為“2023 年 11 月 1 日星期三 05:30:00 GMT+0530 (印度標準時間)”。

示例 5

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

<html>
<body>
   const date = new Date('2023-10-30'); //October 30 2023
   date.setUTCMonth("asd", "vfdva"); //Invalid date

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

輸出

如我們所見，輸出為“NaN”。

列印頁面