Date.prototype.setUTCFullYear()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
setUTCFullYear() 方法根据世界标准时间为一个具体日期设置年份。
尝试一下
const event = new Date("December 31, 1975 23:15:30 GMT-3:00");
console.log(event.getUTCFullYear());
// Expected output: 1976
console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"
event.setUTCFullYear(1975);
console.log(event.toUTCString());
// Expected output: "Wed, 01 Jan 1975 02:15:30 GMT"
语法
dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])
参数
yearValue-
指定年份整数值，例如，1995
monthValue-
可选。指定一个 0-11 之间的整数值，代表从一月到十二月。
dayValue-
可选。指定一个 1-31 之间的整数值，代表月份中的第几天。如果你指定了 dayValue 参数，那么你必须指定 monthValue 参数。
描述
如果你没有指定具体的 monthValue 和 dayValue，将会使用 getUTCMonth 和 getUTCDate 方法的返回值。
如果你指定的参数超出了期待范围，setUTCFullYear() 方法将会根据 Date 对象，更新其他参数和日期信息。例如，如果你将 monthValue 设定为 15，年份会增加 1，月份值则为为 3。
示例
使用 setUTCFullYear()
js
var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setutcfullyear |