設置 Date 對象中用全球標準時間 (UTC) 表示的年份值。

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

參數(shù)

dateObj

必選項。任意 Date 對象。

numYear

必選項。一個等于年份的數(shù)值。

numMonth

可選項。一個等于月份的數(shù)值。如果提供了 numDate，那么也必須提供此項。

numDate

可選項。一個等于日期的數(shù)值。

說明

如果沒有指定可選項，那么所有使用可選項的 set 方法都將使用從相應的 get 方法返回的數(shù)值作為可選項的數(shù)值。例如，如果 numMonth 參數(shù)是可選的，但是沒有被指定，JScript 將使用從 getUTCMonth 方法返回的值作為該參數(shù)的值。

此外，如果參數(shù)的的值超出其范圍或者是負數(shù)，其他被保存的值都將相應地得到修改。

要設置用本地時間表示的年份，請使用 setFullYear 方法。

Date 對象中所支持的年份范圍大約是 1970 年前后各 285,616 年。

示例

下面這個例子說明了 setUTCFullYear 方法的用法。

function SetUTCFullYearDemo(newyear){
   var d, s;                   // 聲明變量。
   d = new Date();             // 創(chuàng)建 Date 對象。
   d.setUTCFullYear(newyear);  // 設置 UTC 完整年份。
   s = "Current setting is ";
   s += d.toUTCString(); 
   return(s);                  //返回新設置。
}

要求

版本 3

請參閱

Date 對象的方法 | getFullYear 方法 | getUTCFullYear 方法 | setFullYear 方法

應用于：Date 對象