【Node.js24.x】Date::setMilliseconds()メソッドの使い方
setMillisecondsメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
setMillisecondsメソッドは、Node.jsの組み込みオブジェクトであるDateクラスのインスタンスに対して、その日付と時刻の「ミリ秒」部分を設定するメソッドです。ミリ秒とは、1秒を1000分の1に分割した単位を指します。
このメソッドを使用すると、既に存在するDateオブジェクトの持つ時刻情報のうち、ミリ秒の部分のみを任意の値に更新することができます。引数には、設定したいミリ秒の値を数値（通常は0から999の範囲）で指定します。もし指定された値が999を超える場合、または負の値が指定された場合でも、このメソッドは内部的に日付と時刻の計算を行い、秒や分などの上位の単位に適切に繰り上げまたは繰り下げて調整します。例えば、1000ミリ秒を指定すると、1秒進んだ状態として解釈されます。
setMillisecondsメソッドを呼び出すと、対象となるDateオブジェクト自身のミリ秒が変更され、年、月、日、時、分、秒などの他の日付要素はそのまま維持されます。また、このメソッドは、ミリ秒が設定された後のDateオブジェクトが表す、1970年1月1日00:00:00 UTC（協定世界時）からの経過ミリ秒数を数値として返します。
システムエンジニアが日付や時刻の情報を扱う際、特にミリ秒単位での精密な時刻調整が必要な場合や、既存のDateオブジェクトの特定の部分だけを効率的に更新したい場合に非常に便利な機能です。
構文(syntax)
1const dateObject = new Date(); 2dateObject.setMilliseconds(500);
引数(parameters)
millisecondsValue
- millisecondsValue: number: 設定するミリ秒数を表す数値
戻り値(return)
number
指定されたミリ秒を設定した後の、Dateオブジェクトのタイムスタンプ（1970年1月1日午前0時0分0秒からの経過ミリ秒数）を数値で返します。