setFullYear 方法

设置 Date 对象中用本地时间表示的年份值。

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

参数

dateObj

必选项。任意 Date 对象。

numYear

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

numMonth

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

numDate

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

说明

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

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

要设置用全球标准时间 (UTC)表示的年份，请使用 setUTCFullYear 方法。

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

示例

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

function SetFullYearDemo(newyear){
   var d, s;                 // 声明变量。
   d = new Date();           // 创建 Date 对象。
   d.setFullYear(newyear);   // 设置年份。
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);                // 返回新的日期设置。
}

要求

版本 3

请参阅

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

应用于： Date 对象