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”。

打印页面