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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setFullYear |
Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 4 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 1.0 | nodejs Full support Yes |
Legend
- Full support
- Full support