共用方式為


setFullYear 方法

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

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

引數

  • numYear
    必要項。 等於年份的數值。

  • numMonth
    選擇項。 等於月份的數值。 一月份的值為 0,而其他月份值則為相繼的連續值。 如果提供 numDate,就必須提供此引數。

  • numDate
    選擇項。 等於月份日期的數值。

備註

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

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

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

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

範例

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

var dtFirst = new Date();
dtFirst.setFullYear(2007);

var dtSecond = new Date();
// 10 is the value for November. 
dtSecond.setFullYear(2008, 10, 3); 

需求

版本 3

套用至︰

Date 物件

請參閱

參考

getFullYear 方法

getUTCFullYear 方法

setUTCFullYear 方法