setFullYear 方法

 

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