JS date setUTCFullYear()
setUTCFullYear()
方法根据世界标准时间为一个具体日期设置年份。
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.setUTCFullYear(yearValue[, monthValue[, dayValue]])
参数
yearValue
指定年份整数值,例如,1995
monthValue
可选。指定一个0-11之间的整数值,代表从一月到十二月。
dayValue
可选。指定一个1-31之间的整数值,代表月份中的第几天。如果你指定了dayValue参数,那么你必须指定monthValue参数。
描述
如果你没有指定具体的monthValue和dayValue,
将会使用 getUTCMonth
和getUTCDate
方法的返回值。
如果你指定的参数超出了期待范围,setUTCFullYear()方法将会根据Date对象,更新其他参数和日期信息。例如,如果你将monthValue设定为15,年份会增加1,月份值则为为3。
例子
使用 setUTCFullYear()
var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
规范
规范版本 | 规范状态 | 注解 |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | 初始定义。 在 JavaScript 1.3实施。 |
ECMAScript 5.1 (ECMA-262) Date.prototype.setUTCFullYear | Standard | |
ECMAScript 2015 (6th Edition, ECMA-262)Date.prototype.setUTCFullYear | Standard | |
ECMAScript Latest Draft (ECMA-262)Date.prototype.setUTCFullYear | Draft |
相关连接