設置 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);                  //返回新設置。}