設置 Date 對象中用本地時間表示的年份值。

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

參數

dateObj

必選項。任意 Date 對象。

numYear

必選項。一個等于年份的數值。

numMonth

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

numDate

可選項。一個等于日期的數值。

說明

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

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

要設置用全球標準時間 (UTC)表示的年份，請使用 setUTCFullYear 方法。

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

示例

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

function SetFullYearDemo(newyear){   var d, s;                 // 聲明變量。   d = new Date();           // 創建 Date 對象。   d.setFullYear(newyear);   // 設置年份。   s = "Current setting is ";   s += d.toLocaleString();    return(s);                // 返回新的日期設置。}