Date.prototype.setUTCFullYear()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

setUTCFullYear() 方法用于修改 Date 实例的年份(根据通用时间)。

试一试

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"

语法

js
setUTCFullYear(yearValue)
setUTCFullYear(yearValue, monthValue)
setUTCFullYear(yearValue, monthValue, dateValue)

参数

yearValue

表示年份的整数。例如,1995。

monthValue 可选

一个整数,表示月份:0 表示一月,1 表示二月,以此类推。

dateValue 可选

表示月份中一天的整数(1-31)。如果指定了 dateValue,则必须同时指定 monthValue

返回值

该方法会直接修改 Date 对象,并返回其新的 时间戳。如果某个参数是 NaN(或被 强制转换NaN 的值,如 undefined),则日期将设置为 无效日期,并返回 NaN

描述

如果您不指定 monthValuedateValue 参数,则将使用从 getUTCMonth()getUTCDate() 方法返回的值。

如果您指定的参数超出预期范围,setUTCFullYear() 会尝试相应地更新 Date 对象中的其他参数和日期信息。例如,如果您为 monthValue 指定 15,年份将增加 1(yearValue + 1),月份将使用 3。

示例

使用 setUTCFullYear()

js
const theBigDay = new Date();
theBigDay.setUTCFullYear(1997);

规范

规范
ECMAScript® 2026 语言规范
# sec-date.prototype.setutcfullyear

浏览器兼容性

另见