setFullYear 方法

發行項
08/21/2008

更新：2007 年 11 月

利用本地時間設定 Date 物件的年份值。

 function setFullYear(numYear : Number [, numMonth Number [, numDate Number]])

引數

numYear
必要項。等於年份的數值。
numMonth
選擇項。等於月份的數值。如果指定 numDate 的話，就必須指定這一項。
numDate
選擇項。等於日期的數值。

備註

如果不指定選擇性引數，則所有需要選擇性引數的 set 方法都會使用對應的 get 方法所傳回的值。例如，如果 numMonth 引數是沒有指定的選擇性引數，JScript 就會使用 getMonth 方法所傳回的值。

此外，如果引數值大於其範圍或者是負數的話，其他的儲存值都會跟著修改。

若要利用 Coordinated Universal Time (UTC) 設定年份，請使用 setUTCFullYear 方法。

date 物件支援的年份範圍大約可以涵蓋 1970 年前後各約 285,616 年。

範例

以下範例說明如何使用 setFullYear 方法：

function SetFullYearDemo(newyear){
   var d, s;                 //Declare variables.
   d = new Date();           //Create Date object.
   d.setFullYear(newyear);   //Set year.
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);                //Return new date setting.
}