setFullYear() 方法根据本地时间为一个日期对象设置年份。
JavaScript Demo: Date.setFullYear()
const event = new Date("August 19, 1975 23:15:30");
event.setFullYear(1969);
console.log(event.getFullYear());
// Expected output: 1969
event.setFullYear(0);
console.log(event.getFullYear());
// Expected output: 0
语法
dateObj.setFullYear(yearValue[, monthValue[, dayValue]])
参数
yearValue- : 指定年份的整数值,例如 1995。
monthValue- : 一个 0 到 11 之间的整数值,表示从一月到十二月。
dayValue- : 一个 1 到 31 之间的整数值,表示月份中的第几天。如果你指定了
dayValue参数,就必须同时指定monthValue。
- : 一个 1 到 31 之间的整数值,表示月份中的第几天。如果你指定了
描述
如果没有指定 monthValue 和dayValue 参数,将会使用 getMonth 和getDate 方法的返回值。
如果有一个参数超出了合理的范围,setFullYear 方法会更新其他参数值,日期对象的日期值也会被相应更新。例如,为 monthValue 指定 15,则年份会加 1,月份值会为 3。
示例
示例:使用setFullYear方法
var theBigDay = new Date();
theBigDay.setFullYear(1997);
规范
浏览器兼容性
参见
- Date.prototype.getUTCFullYear()
- Date.prototype.setUTCFullYear()
- Date.prototype.setYear()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
