| JScript  | [语言参考](#) | |-----|-----| # 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 对象](#) [© 2000 Microsoft Corporation 版权所有。保留所有权利。使用规定。](#)