Date.prototype.setUTCFullYear()

基线 广泛可用

此功能已得到充分确立，并且可以在许多设备和浏览器版本上运行。它已在浏览器中可用，自 2015 年 7 月.

setUTCFullYear() 方法是 Date 实例的方法，它根据世界标准时间更改此日期的年份。

试一试

语法

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

参数

yearValue

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

monthValue 可选

表示月份的整数：0 表示 1 月，1 表示 2 月，依此类推。

dateValue 可选

表示一个月中的日期的整数，介于 1 和 31 之间。如果您指定 dateValue，则还必须指定 monthValue。

返回值

就地更改 Date 对象，并返回其新的 时间戳。如果参数为 NaN（或其他被 强制转换为 NaN 的值，例如 undefined），则日期设置为 无效日期 并返回 NaN。

描述

如果您未指定 monthValue 和 dateValue 参数，则使用 getUTCMonth() 和 getUTCDate() 方法返回的值。

如果您指定的参数超出预期范围，则 setUTCFullYear() 会尝试更新其他参数以及 Date 对象中的日期信息。例如，如果您为 monthValue 指定 15，则年份加 1（yearValue + 1），并且月份使用 3。

示例

使用 setUTCFullYear()

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

规范

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅