JavaScript Date 的 setUTCMonth() 方法

JavaScript 的 Date.setUTCMonth() 方法是一个 Date 对象方法，它允许您根据协调世界时 (UTC) 设置日期的月份。此方法的返回值是 Date 对象的更新时间戳，反映了修改月份所带来的变化。我们还可以选择性地修改 Date 对象的日期值。如果 Date 对象的日期无效，此方法将返回"NaN"作为结果。

语法

以下是 JavaScript Date 的 setUTCMonth() 方法的语法 -

setUTCMonth(monthValue, dateValue);

参数

此方法接受两个参数。具体描述如下 -

• monthValue − 0 到 11 之间的整数，其中 0 表示一月，11 表示十二月。
  • 如果提供 -1，则结果为上一年的最后一个月。
  • 如果提供 12，则结果为下一年的第一个月。
• dateValue (可选) − 1 到 31 之间的整数。
  • 如果提供 0，则结​​果为上个月的最后一天。
  • 如果提供 -1，则结果为上个月最后一天的前一天。
  • 如果提供 32，则结果为下个月的第一天(如果该月有 31 天)。
  • 如果提供 32，则结果为下个月的第二天(如果该月有 30 天)。

返回值

此方法返回修改月份和日期(可选)后的新日期的时间戳。

示例 1

在下面的示例中，我们使用 JavaScript Date 的 setUTCMonth() 方法将 Date 对象的"月份"设置为 UTC 时间的 10(十一月)-

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

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

输出

如果我们执行上述程序，日期对象的月份将被设置为 10。

示例 2

在这里，我们根据 UTC 将月份设置为 10(十一月)，日期设置为(25)。

<html>
<body>
<script>
   let date = new Date();
   date.setUTCMonth(10, 25); // 将月份设置为 11 月，日期设置为 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 "。

示例 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"。