`setFullYear()` 方法根据本地时间为一个日期对象设置年份。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

## 语法

    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`方法

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

## 规范

规范版本 | 规范状态 | 注解
--- | --- | ---
ECMAScript 1st Edition. Implemented in JavaScript 1.3 | Standard | Initial definition.
ECMAScript 5.1 (ECMA-262) Date.prototype.setFullYear | Standard |
ECMAScript 2015 (6th Edition, ECMA-262) Date.prototype.setFullYear | Standard |

## 浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

| Desktop | Mobile | Server
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | Safari on iOS | Samsung Internet | Node.js
`setFullYear` | Chrome Full support Yes | Edge Full support 12 | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes

### Legend

Full support
  Full support

## 相关链接

- `Date.prototype.getUTCFullYear()`
- `Date.prototype.setUTCFullYear()`
- `Date.prototype.setYear()`