JavaScript 中的 setFullYear()
方法用于设置一个日期对象的年份部分。这个方法是 Date
对象的原型方法之一,可以通过调用日期对象的实例来使用。
语法
dateObject.setFullYear(year[, month[, date]])
year
: 必需,一个四位数的年份值month
: 可选,一个从 0 到 11 的整数,表示月份date
: 可选,一个从 1 到 31 的整数,表示日期
返回值
该方法返回设置后的日期对象。如果超出了有效日期范围,日期对象的其他部分也会相应地调整。
示例
设置年份
const date = new Date(); date.setFullYear(2022); console.log(date); // 输出:Wed Feb 02 2022 15:42:12 GMT+0800 (中国标准时间)
设置年份和月份
const date = new Date(); date.setFullYear(2023, 11); console.log(date); // 输出:Thu Dec 02 2023 15:42:12 GMT+0800 (中国标准时间)
设置年份、月份和日期
const date = new Date(); date.setFullYear(2024, 5, 15); console.log(date); // 输出:Fri Jun 15 2024 15:42:12 GMT+0800 (中国标准时间)
注意事项
- 如果设置的年份小于 1000 或大于 9999,
setFullYear()
方法会自动调整其他日期部分以满足有效日期的要求。 - 如果省略
month
或date
参数,则会保持当前日期对象的对应部分不变。
通过 setFullYear()
方法,可以方便地设置日期对象的年份部分,灵活应用于各种日期操作场景中。