setUTCFullYear 方法

發行項
08/21/2008

更新：2007 年 11 月

使用 Coordinated Universal Time (UTC) 設定 Date 物件中的年份值。

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

引數

numYear
必要項。等於年份的數值。
numMonth
選擇項。等於月份的數值。
numDate
選擇項。等於日期的數值。

備註

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

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

若要利用本地時間設定年份，請使用 setFullYear 方法。

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

範例

下列範例說明如何使用 setUTCFullYear 方法。

function SetUTCFullYearDemo(newyear){
   var d, s;                   //Declare variables.
   d = new Date();             //Create Date object.
   d.setUTCFullYear(newyear);  //Set UTC full year.
   s = "Current setting is ";
   s += d.toUTCString(); 
   return(s);                  //Return new setting.
}