【Node.js24.x】Date::setSeconds()メソッドの使い方
setSecondsメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
setSecondsメソッドは、Node.js環境において、既存のDateオブジェクトの「秒」の値を設定するメソッドです。このメソッドを使用することで、日付や時刻情報の中で秒の部分を特定の値に変更したり、調整したりすることができます。
基本的な使用方法はdateObj.setSeconds(secondsValue[, msValue])という形になります。
第一引数であるsecondsValueには、設定したい秒の値を0から59の範囲で整数として指定します。例えば、30を指定すれば秒は30に設定されます。もし60以上の値を指定した場合、分が自動的に調整され、秒は0から59の範囲に正規化されます。例えば、60を指定すると分が1増え、秒は0になります。
第二引数であるmsValueはオプションで、設定したいミリ秒の値を0から999の範囲で整数として指定します。この引数を省略した場合、ミリ秒の値は変更されずにそのまま保持されます。
これらの引数に指定された値が通常の範囲外であっても、Dateオブジェクトはそれに応じて分や時、日などの他の日付要素を自動的に調整します。
setSecondsメソッドを実行すると、対象のDateオブジェクトが新しい秒とミリ秒（指定した場合）で更新されます。メソッドの戻り値は、1970年1月1日 00:00:00 UTCから変更後のDateオブジェクトが表す時刻までのミリ秒数を示す数値です。
このメソッドは元のDateオブジェクトを直接変更（破壊的な操作）しますので、その挙動を理解して利用することが重要です。これにより、時刻の秒単位での正確な制御や調整が可能となります。
構文(syntax)
1const currentDateTime = new Date(); 2currentDateTime.setSeconds(30, 500);
引数(parameters)
secondsValue, msValue
- secondsValue: number: 秒を指定する数値
- msValue: number = 0: ミリ秒を指定する数値（省略可能、デフォルトは0）
戻り値(return)
number
このメソッドは、Dateオブジェクトで設定されたエポック秒（1970年1月1日午前0時0分0秒UTCからの経過秒数）を数値で返します。