setUTCFullYear 方法
更新:2007 年 11 月
使用协调通用时间 (UTC) 设置 Date 对象中的年份值。
function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])
参数
numYear
必选。一个等于年份的数值。numMonth
可选项。一个等于月份的数值。numDate
可选项。一个等于日期的数值。
备注
如果您没有指定可选参数,那么所有采用可选参数的 set 方法都将使用相应的 get 方法返回的值。例如,如果 numMonth 参数是可选的,但是没有被指定,则 JScript 将使用 getUTCMonth 方法的返回值。
此外,如果参数的值大于其取值范围或者是负数,则其他存储的值都将得到相应的修改。
若要使用当地时间设置年份,请使用 setFullYear 方法。
Date 对象中所支持的年份范围大约是 1970 年前后 285,616 年。
示例
下面的示例阐释了 setUTCFullYear 方法的用法。
function SetUTCFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setUTCFullYear(newyear); //Set UTC full year.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}