JavaScript – Date setUTCFullYear() 方法

简介

在 JavaScript 中，Date setUTCFullYear() 方法用于设置日期的年份（四个数字），以协调世界时（UTC）为标准。

这个方法并不影响日期对象上当前时区设置的年份，而是直接修改 UTC 时间的年份值。

setUTCFullYear() 方法还有两个可选的参数，用于设置月份和日期。

语法如下：

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

参数

yearValue 必须，一个 4 位数的年份值。
monthValue 可选，一个从 0 到 11 的月份值。若省略，则使用当前日期对象的月份值。
dayValue 可选，一个从 1 到 31 的日期值。若省略，则使用当前日期对象的日期值。

返回值

返回设置后的日期对象。如果参数不符合要求，则返回一个无效的日期对象。

示例

以下是一些使用 setUTCFullYear() 方法的示例：

// 通过 setUTCFullYear() 方法设置年份
var aDate = new Date();
aDate.setUTCFullYear(2022);
console.log(aDate); // 输出：Thu Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)

// 通过 setUTCFullYear() 方法设置年份和月份
var anotherDate = new Date();
anotherDate.setUTCFullYear(2023, 3); // 2023 年 4 月
console.log(anotherDate); // 输出：Sun Apr 01 2023 00:00:00 GMT+0800 (中国标准时间)

// 通过 setUTCFullYear() 方法设置年份、月份和日期
var yetAnotherDate = new Date();
yetAnotherDate.setUTCFullYear(2024, 5, 10); // 2024 年 6 月 10 日
console.log(yetAnotherDate); // 输出：Tue Jun 11 2024 00:00:00 GMT+0800 (中国标准时间)