JavaScript

Date.prototype.setUTCMonth() メソッド

 編集:2022.12.05 by T.A.

[Edge]。→

Date に日時の「月」(任意で「日」も)を協定世界時に基づき設定します。

戻り値として、更新後の日時の、協定世界時(UTC)での 1970 年 1 月 1 日 0 時 0 分 0 秒からのミリ秒単位の数値を返します。

構文
Date.setUTCMonth(monthValue[, dayValue])
Date Date
monthValue 「月」を表す整数値(0~11(1月~12月)※。
dayValue 省略可。「日」を表す整数値(1~31)※。

※: 範囲を超えた値は Date と設定値を考慮して増減計算して設定されます。

返り値

更新後の日時の、協定世界時(UTC)での 1970 年 1 月 1 日 0 時 0 分 0 秒からのミリ秒単位の数値。

解説/mdn

dayValue 引数を指定しない場合、getUTCDate() メソッドから返される値が使われます。

指定した値が期待される日時の範囲外の場合、それに応じて setUTCMonth() が Date オブジェクトの日付情報の更新を試みます。例えば、monthValue に 15 を指定した場合、年に 1 が加算され、月が 3 になります。

/mdn
var theBigDay = new Date();
D=theBigDay.setUTCMonth(11); //
DA=new Date('2020-10-05');  //2020年10月5日。
T=DA.setUTCMonth(11);  //12月として設定。
DO=new Date(T);
D=DO.toISOString();  //=[string]:2020-12-05T00:00:00.000Z

T=DA.setUTCMonth(-1);  //1月の-1月として設定。
DO=new Date(T);
D=DO.toISOString();  //=[string]:2019-12-05T00:00:00.000Z

テスト