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.
}

要求

版本 3

应用于:

Date 对象

请参见

参考

getFullYear 方法

getUTCFullYear 方法

setFullYear 方法