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 July 2015.

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® 2025 Language Specification
# sec-date.prototype.setfullyear

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setFullYear

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

参见