通过

setFullYear 方法

  • 项目

更新：2007 年 11 月

使用当地时间设置 Date 对象中的年份值。

function setFullYear(numYear : Number [, numMonth Number [, numDate Number]])

参数

  • numYear
    必选。一个等于年份的数值。

  • numMonth
    可选项。一个等于月份的数值。如果提供了 numDate，那么必须提供此参数。

  • numDate
    可选项。一个等于日期的数值。

备注

如果未指定可选参数，那么所有采用可选参数的 set 方法都将使用相应的 get 方法返回的数值。例如，如果 numMonth 参数是可选的，但是尚未指定，则 JScript 将使用 getMonth 方法的返回值。

此外，如果参数的值大于其取值范围或者是负数，则其他存储的值都将得到相应的修改。

若要使用协调通用时间 (UTC) 设置年份，请使用 setUTCFullYear 方法。

Date 对象中所支持的年份范围大约是 1970 年前后 285,616 年。

示例

下面的示例阐释了 setFullYear 方法的用法：

function SetFullYearDemo(newyear){
   var d, s;                 //Declare variables.
   d = new Date();           //Create Date object.
   d.setFullYear(newyear);   //Set year.
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);                //Return new date setting.
}

要求

版本 3

应用于：

Date 对象

请参见

参考

getFullYear 方法

getUTCFullYear 方法

setUTCFullYear 方法