JavaScript 日期 setUTCFullYear() 方法

简介

setUTCFullYear() 方法用于设置 Date 对象的年份，以协调世界时（UTC）指定。这个方法不会改变本地时间。

语法

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])

参数

• yearValue：一个整数，表示要设置的年份（必选）。
• monthValue：一个整数，来表示月份（可选）。如果未指定该参数，则使用当前月份。
• dayValue：一个整数，来表示日期（可选）。如果未指定该参数，则使用当前日期。

返回值

设置后的 Date 对象。

示例

// 创建 Date 对象
var date = new Date('March 28, 2021 00:00:00');

// 设置年份和月份
date.setUTCFullYear(2022, 0 /* January */ );

// 打印日期
console.log(date.toUTCString()); // "Sun, 01 Jan 2022 00:00:00 GMT"

注意事项

• setUTCFullYear() 方法会改变原 Date 对象的状态，而并不会创建一个新的对象。
• 如果指定的日期超出了该月份的最大天数，该方法会将之调整到该月份的最后一天。
• 如果指定的日期小于 1，则会将之调整为上一个月的最后一天。例如，在 2021 年 3 月 0 日的情况下，setUTCFullYear(2021, 2, 0) 实际上是设置了 2021 年 2 月 28 日。

参考链接

• MDN - setUTCFullYear()