CodePlayer

setYear()函数用于基于UTC时间返回当前Date对象中的年份值。也就是"年月日"中"年"的数值。强烈建议不要使用该方法！

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

语法

setYear()函数已过时。之所以提供这个方法，只是为了向后兼容。请改用setFullYear()函数。

date.setYear( year )

参数

注意：对于1900~1999年这段时间而言，参数year应该为指定年份的后面两位整数，也就是该年份与1900年之间的差值。而对于该段时间之外的年份，参数应该为完整的年份值。例如，设置为1965年，需要传入参数65；而设置为1636或2184年，需要传入的参数则是1636或2184。

返回值

setYear()函数的返回值为Number类型，返回当前Date对象的年份值。

示例&说明

//定义一个本地时间的Date对象"2008-08-08"
var date = new Date(2008, 7, 8);
document.writeln( date.toLocaleDateString() ); // 2008年8月8日

date.setYear(49);
document.writeln( date.toLocaleDateString() ); // 1949年8月8日

date.setYear(-108);
// 部分浏览器的显示存在问题，例如：FireFox显示 为"109年8月8日"(没有负号)
// Chrome显示为"109年8月11日" (没有负号，日期也有问题)
document.writeln( date.toLocaleDateString() ); // Mon Aug 8 109 B.C.(IE浏览器的显示，意即公元前 109年8月8日)

date.setYear(2012);
document.writeln( date.toLocaleDateString() ); // 2012年8月8日

运行代码