Date.prototype.setFullYear()

基线 广泛可用

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

setFullYear() 方法是 Date 实例的方法，它根据本地时间更改此日期的年份、月份和/或日期。

试一试

语法

js
setFullYear(yearValue)
setFullYear(yearValue, monthValue)
setFullYear(yearValue, monthValue, dateValue)

参数

yearValue

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

monthValue 可选

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

dateValue 可选

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

返回值

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

描述

如果不指定 monthValue 和 dateValue 参数，则使用与 getMonth() 和 getDate() 返回的值相同的值。

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

示例

使用 setFullYear()

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

规范

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

浏览器兼容性

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

另请参阅