CodePlayer

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

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

语法

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

参数

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

返回值

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

示例&说明

//定义一个Date对象"2012-03-15 13:11:43"
var date = new Date(2012, 2, 15, 13, 11, 43);
document.writeln( date.toLocaleString() ); // 2012年3月15日 13:11:43

date.setFullYear(2013, 5);
document.writeln( date.toLocaleString() ); // 2013年6月15日 13:11:43

date.setFullYear(2012, 20, 5);
document.writeln( date.toLocaleString() ); // 2013年9月5日 13:11:43

date.setFullYear(2012, 5, -30);
document.writeln( date.toLocaleString() ); // 2012年5月1日 13:11:43

运行代码