【JavaScript ECMAScript】Date::Date.prototype.setMillisecondsインスタンスメソッドの使い方
Date.prototype.setMilliseconds()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Date.prototype.setMilliseconds()メソッドは、JavaScriptのDateオブジェクトが保持する日付と時刻のミリ秒の値を設定するメソッドです。このメソッドは、指定された値でDateオブジェクトのミリ秒部分を直接変更します。
引数には、設定したいミリ秒を表す0から999までの整数を指定します。この範囲外の値を指定した場合、JavaScriptエンジンは自動的に秒、分、時、日などの上位の日付要素を適切に調整します。例えば、1000ミリ秒を設定すると、1秒分が加算され、秒の値が更新されるといった動作をします。
このメソッドは、対象のDateオブジェクトの内部状態を変更する破壊的な操作です。メソッドの戻り値としては、ミリ秒が設定されたDateオブジェクトの、UTC 1970年1月1日00:00:00からの経過ミリ秒数として更新された時刻を表す数値が返されます。この機能は、日付や時刻のミリ秒単位での正確な調整が必要な場面で活用され、システムにおける時刻情報の操作において重要な役割を果たします。
公式リファレンス: Date.prototype.setMilliseconds()
構文(syntax)
1const dateObject = new Date(); 2dateObject.setMilliseconds(500);
引数(parameters)
msValue
- msValue: number: ミリ秒を表す数値。0から999までの範囲で指定します。
戻り値(return)
number
このメソッドは、Dateオブジェクトのミリ秒値を設定した後の、UTC（協定世界時）でのミリ秒単位のエポックタイム（1970年1月1日午前0時0分0秒からの経過ミリ秒数）を返します。