JavaScript Date 的 setUTCFullYear() 方法

JavaScript 的 Date.setUTCFullYear() 方法用于根据协调世界时 (UTC) 设置 Date 对象的年份。此方法允许您修改 Date 对象的年份部分，而无需更改其他日期部分(例如月份或日期)。

此方法的返回值是 Date 对象的更新时间戳，该时间戳反映了修改年份后的变化。我们还可以选择性地修改 Date 对象的月份和日期值。

语法

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

setUTCFullYear(yearValue, monthValue, dateValue);

参数

此方法接受三个参数。具体说明如下:-

• yearValue - 一个整数，表示新的年份(四位数字)。
• monthValue (可选) - 一个介于 0 到 11 之间的整数，其中 0 表示一月，11 表示十二月。
  • 如果提供 -1，则返回上一年的最后一个月。
  • 如果提供 12，则返回下一年的第一个月。
• dateValue (可选) − 1 到 31 之间的整数。
  • 如果提供 0，则返回上个月的最后一天。
  • 如果提供 -1，则返回上个月最后一天的前一天。
  • 如果提供 32，则返回下个月的第一天(如果该月有 31 天)。
  • 如果提供 32，则返回下个月的第二天(如果该月有 30 天)。

返回值

setUTCFullYear() 的返回值是 1970 年 1 月 1 日与设置年份后更新的 Date 对象之间的毫秒数。

示例 1

在以下示例中，我们使用 JavaScript Date setUTCFullYear() 方法将 Date 对象的年份设置为 2023 年 -

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setUTCFullYear(2025);

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

输出

如果我们执行上述程序，年份将设置为 2023 年。

示例 2

在这里，我们将年份设置为 2023 年，月份设置为 10 月(11 月)，日期设置为 25 日 -

<html>
<body>
   const specificDate = new Date();
   specificDate.setUTCFullYear(2024, 10, 25); //Will set to November 25, 2024

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

输出

执行后，此程序将返回包含指定日期的时间戳。

示例 3

如果我们将 monthValue 指定为"12"，则年份将增加 1(yearValue + 1)，并且月份将使用 0。

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

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

输出

返回时间戳"2024年1月15日星期日 05:30:00"。

示例 4

如果我们将 dateValue 指定为"32"，则月份将加 1(如果该月份有 31 天)，并返回下个月的第一天。

<html>
<body>
<script>
   const existingDate = new Date('2024-03-30'); //March 2024 has 31 days.
   existingDate.setUTCFullYear(2024, 2, 32); 

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

输出

返回时间戳"2024年4月1日星期一 05:30:00 "。

示例 5

如果我们将无效日期值作为参数传递给此函数，则该日期将被设置为"无效日期"，并返回结果"NaN" -

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setUTCFullYear("dfbgf");

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

输出

如我们所见，输出结果为"NaN"。