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

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

參數(shù)

dateObj

必選項。任意 Date 對象。

numYear

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

numMonth

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

numDate

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

說明

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

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

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

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

示例

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

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

要求

版本 3

請參閱

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

應(yīng)用于：Date 對象