【JavaScript ECMAScript】Date::Date.prototype.setUTCSecondsインスタンスメソッドの使い方

Date.prototype.setUTCSeconds()メソッドは、JavaScriptのDateオブジェクトが保持する日付と時刻のうち、協定世界時（UTC）における「秒」の値を設定するために使用されるメソッドです。

このメソッドを呼び出すと、対象となるDateインスタンスの秒の部分が更新されます。引数として、設定したい秒の値を整数で指定します。この値は0から59の範囲が一般的ですが、例えば60を指定すると、秒は0にリセットされ、同時に分が1繰り上がるといったように、範囲外の値が指定された場合でも、Dateオブジェクトは自動的に上位の時間単位（分、時、日など）を適切に調整し、日付と時刻の整合性を保ちます。オプションとして、第二引数にミリ秒の値を0から999の範囲で指定することも可能です。これにより、秒単位だけでなく、さらに細かいミリ秒単位での設定も行えます。

メソッドの実行後、更新されたDateオブジェクトが表す、1970年1月1日00:00:00 UTCからの経過ミリ秒数が数値として返されます。この機能は、タイムゾーンに依存しない国際的な日時情報を扱うシステム開発において特に重要です。システムエンジニアが正確な日時操作を行う際に、UTC基準で日付オブジェクトの秒やミリ秒を柔軟に設定・調整したい場合に、このsetUTCSeconds()メソッドが役立ちます。

Copy
1const dateObj = new Date();
2dateObj.setUTCSeconds(secondsValue, msValue);

secondsValue, msValue = 0

• secondsValue: number: UTCでの秒を表す数値。0から59の範囲で指定します。
• msValue: number = 0: UTCでのミリ秒を表す数値。0から999の範囲で指定します。省略された場合は0として扱われます。

number

このメソッドは、UTC（協定世界時）における日付オブジェクトの秒を設定し、その結果として設定後のミリ秒単位の時刻値を返します。