setMonth メソッド

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

Date オブジェクトの日付の月の部分を現地時間で設定します。

function setMonth(numMonth : Number [, dateVal : Number])

引数

numMonth
必ず指定します。設定する月を表す数値を指定します。
dateVal
省略可能です。設定する日を表す数値を指定します。省略した場合は、getDate メソッドにより返される値が使用されます。

解説

月の値を世界協定時刻 (UTC) で設定するには、setUTCMonth メソッドを使用してください。

引数 numMonth に 11 を超える値 (1 月は 0) または負の値を指定すると、値に応じて格納されている年の値が変更されます。たとえば、日付が "Jan 5, 1996" と格納されている場合に setMonth(14) メソッドを使用すると、日付は "Mar 5, 1997" に変更されます。

使用例

setMonth メソッドの使用例を次に示します。

function SetMonthDemo(newmonth){
   var d, s;               //Declare variables.
   d = new Date();         //Create Date object.
   d.setMonth(newmonth);   //Set month.
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);              //Return new setting.
}