| 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 版權所有。保留所有權利。使用規定。](#)