CodePlayer

setUTCFullYear()函数用于基于UTC时间设置当前Date对象的年份值。也就是"年月日"中"年"的数值。setUTCFullYear()函数还可同时设置月份值和日期值。

该函数属于Date对象，所有主流浏览器均支持该函数。

语法

date.setUTCFullYear( year [, month [, dateNumber]] )

参数

参数month、dateNumber可以超出常规的0 ~ 11、1 ~ 31的取值范围，也可以为负数，Date对象内部会自动计算并转换为对应的日期。
如果提供了dateNumber参数，就必须提供month参数。
注意，参数month的值比实际月份小1。

返回值

setUTCFullYear()函数没有返回值(或者说，返回值为undefined)。

示例&说明

//定义一个本地时间的Date对象"2013-03-15 05:11:43"
var date = new Date(2012, 2, 15, 5, 11, 43);
document.writeln( date.toUTCString() ); // Wed, 14 Mar 2012 21:11:43 UTC

date.setUTCFullYear(2013, 5);
document.writeln( date.toUTCString() ); // Fri, 14 Jun 2013 21:11:43 UTC

date.setUTCFullYear(2012, 20, 5);
document.writeln( date.toUTCString() ); // Thu, 5 Sep 2013 21:11:43 UTC

date.setUTCFullYear(2012, 5, -30);
document.writeln( date.toUTCString() ); // Tue, 1 May 2012 21:11:43 UTC

运行代码