setUTCFullYear 方法

设置 Date 对象中用全球标准时间 (UTC)表示的年份值。

dateObj.setUTCFullYear(numYear[, numMonth[, numDate]])

参数

dateObj

必选项。任意 Date 对象。

numYear

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

numMonth

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

numDate

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

说明

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

此外，如果参数的的值超出其范围或者是负数，其他被保存的值都将相应地得到修改。

要设置用本地时间表示的年份，请使用 setFullYear 方法。

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

示例

下面这个例子说明了 setUTCFullYear 方法的用法。

function SetUTCFullYearDemo(newyear){
   var d, s;                   // 声明变量。
   d = new Date();             // 创建 Date 对象。
   d.setUTCFullYear(newyear);  // 设置 UTC 完整年份。
   s = "Current setting is ";
   s += d.toUTCString(); 
   return(s);                  //返回新设置。
}

要求

版本 3

请参阅

Date 对象的方法 | getFullYear 方法 | getUTCFullYear 方法 | setFullYear 方法

应用于： Date 对象