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