请参阅                  应用于

描述

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

语法

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

setFullYear 方法的语法有下面这些部分：

部分	描述
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();
  d.setFullYear(newyear);
  s = "Current setting is ";
  s += d.toLocaleString(); 
  return(s);
}