【Node.js24.x】Date::setUTCSeconds()メソッドの使い方
setUTCSecondsメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
setUTCSecondsメソッドは、Node.jsの組み込みオブジェクトであるDateに対して、協定世界時（UTC）における「秒」の値を設定するメソッドです。このメソッドは、特定の日付や時刻の秒の部分を厳密に操作したい場合に使用します。
setUTCSecondsメソッドは、主に一つまたは二つの引数を受け取ります。最初の引数は必須で、設定したい秒の値を0から59までの整数で指定します。二つ目の引数はオプションで、設定したいミリ秒の値を0から999までの整数で指定できます。このミリ秒の引数を省略した場合、Dateオブジェクトに既に設定されているミリ秒の値がそのまま保持されます。
メソッドを実行すると、設定後のDateオブジェクトが示す、1970年1月1日00:00:00 UTCからの経過ミリ秒数を数値として返します。このメソッドは、Dateオブジェクトの「秒」と、もし指定されれば「ミリ秒」の値のみを変更し、分、時、日、月、年などの他の日付や時刻の要素には影響を与えません。
システムがタイムゾーンに依存せず、普遍的な時刻情報に基づいて処理を行う必要がある場合に特に有用です。日付や時刻の厳密な管理、例えばログのタイムスタンプやイベントのスケジューリングなどで、秒単位の調整を行う際に重要な役割を果たします。
構文(syntax)
1const dateObj = new Date(); 2dateObj.setUTCSeconds(secondsValue, msValue);
引数(parameters)
secondsValue, msValue = 0
- secondsValue: number: 設定する秒数を表す数値。0から59の範囲で指定します。
- msValue: number = 0: 設定するミリ秒数を表す数値。0から999の範囲で指定します。省略された場合は0として扱われます。
戻り値(return)
number
setUTCSecondsメソッドは、指定したUTC（協定世界時）での秒数を設定した後の、Dateオブジェクトが表すミリ秒単位のUNIXタイムスタンプを返します。