JavaScript

Date.prototype.setMinutes()メソッド

 編集:2022.12.05 by T.A.

[Edge]。→

Date に日時の「分」(オプションで「秒」「ミリ秒」)を地方時に基づき設定します。戻り値として、更新後の日時の、協定世界時(UTC)での 1970 年 1 月 1 日 0 時 0 分 0 秒からのミリ秒単位の数値が返されます。

構文
Date.setMinutes(minutesValue[, secondsValue[, msValue]])

JavaScript 1.3 より前のバージョン:

Date.setMinutes(minutesValue)
Date Date
minutesValue 「分」を表す 0 から 59 までの間の整数値。
secondsValue 省略可。「秒」を表す整数の数値(0~59)。範囲外の値は、その超えた分だけ設定日時が増減します。
msValue 省略可。「ミリ秒」を表す整数の数値(0~999)。範囲外の値は、その超えた分だけ設定日時が増減します。
返り値

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

解説

secondsValue および msValue 引数を指定しない場合、getSeconds()getMilliseconds() メソッドから返される値が使われます。

指定した値が期待される日時の範囲外の場合、それに応じて setMinutes() が Date オブジェクトの日付情報の更新を試みます。例えば、secondsValue に 100 を指定した場合、分に 1 が加算(minutesValue + 1)され、秒が 40 になります。

/mdn
var theBigDay = new Date();
D=theBigDay.setMinutes(45); //=1659789939418。theBigDay=[object]:Sat Aug 06 2022 21:45:06 GMT+0900 (日本標準時)
Dat=new Date("2020-3-5");  //日時指定で Date オブジェクト作成。
D=Dat.toLocaleString();    //見やすく表示する。
	//=[string]:2020/3/5 0:00:00
N=Dat.setMinutes(10);     //「分」の設定。
	//=[number]:1583334600000
DA=Dat.toLocaleString();  //更新後の日時を見やすく表示。
	//=[string]:2020/3/5 0:10:00
N=Dat.setMinutes(-1);     //「分」の設定(範囲外)。
DA=Dat.toLocaleString();  //更新後の日時を見やすく表示。
	//=[string]:2020/3/4 23:59:00

テスト