JavaScript

Date.prototype.setSeconds() メソッド

 編集:2022.12.05 by T.A.

[Edge]。→

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

構文
Date.setSeconds(secondsValue[, msValue])

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

Date.setSeconds(secondsValue)
Date Date
secondsValue 「秒」を表す整数の数値(0~59)。範囲外の値はその超えた分の設定日時が増減します。
msValue 省略可。「ミリ秒」を表す整数の数値(0~999)。¶範囲外の値はその超えた分の設定日時が増減します。
返値

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

解説/mdn

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

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

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

テスト