setUTCFullYear 方法

  • 项目

使用协调通用时间 (UTC) 设置 Date 对象中的年份值。

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

实参

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

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

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

备注

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

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

若要使用当地时间设置年份，请使用 setFullYear 方法。

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

示例

下面的示例阐释了 setUTCFullYear 方法的用法。

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

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

print (dtFirst.toUTCString());
print (dtSecond.toUTCString());

要求

版本 3

应用于：

Date 对象

请参见

参考

getFullYear 方法

getUTCFullYear 方法

setFullYear 方法