setFullYear 方法

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

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

实参

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

  • numMonth
    可选。 一个等于月份的数值。 一月的值为 0,其他月份值依次递增。 如果提供了 numDate,那么必须提供此参数。

  • numDate
    可选。 一个表示一个月中的某一天的数值。

备注

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

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

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

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

示例

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

var dtFirst = new Date();
dtFirst.setFullYear(2007);

var dtSecond = new Date();
// 10 is the value for November. 
dtSecond.setFullYear(2008, 10, 3); 

要求

版本 3

应用于:

Date 对象

请参见

参考

getFullYear 方法

getUTCFullYear 方法

setUTCFullYear 方法