此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

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: 1969

event.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

描述

如果没有指定 monthValuedayValue 参数,将会使用 getMonthgetDate 方法的返回值。

如果有一个参数超出了合理的范围,setFullYear 方法会更新其他参数值,日期对象的日期值也会被相应更新。例如,为 monthValue 指定 15,则年份会加 1,月份值会为 3。

示例

示例:使用setFullYear方法

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

规范

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.setfullyear

浏览器兼容性

参见