此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
Date.prototype.setFullYear()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
setFullYear() 方法根据本地时间为一个日期对象设置年份。
尝试一下
const event = new Date("August 19, 1975 23:15:30");event.setFullYear(1969);console.log(event.getFullYear());// Expected output: 1969event.setFullYear(0);console.log(event.getFullYear());// Expected output: 0语法
js
dateObj.setFullYear(yearValue[, monthValue[, dayValue]])参数
yearValue指定年份的整数值，例如 1995。
monthValue一个 0 到 11 之间的整数值，表示从一月到十二月。
dayValue一个 1 到 31 之间的整数值，表示月份中的第几天。如果你指定了
dayValue参数，就必须同时指定monthValue。
描述
如果没有指定monthValue 和dayValue 参数，将会使用getMonth 和getDate 方法的返回值。
如果有一个参数超出了合理的范围，setFullYear 方法会更新其他参数值，日期对象的日期值也会被相应更新。例如，为monthValue 指定 15，则年份会加 1，月份值会为 3。
示例
示例：使用setFullYear方法
js
var theBigDay = new Date();theBigDay.setFullYear(1997);规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setfullyear |