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

Date.prototype.setUTCMilliseconds()メソッドは、指定されたDateオブジェクトのUTC（協定世界時）におけるミリ秒の値を設定するメソッドです。このメソッドは、既存のDateオブジェクトのインスタンスに対して呼び出され、日付の「ミリ秒」部分のみを変更します。年、月、日、時、分、秒といった他の日付の要素は変更されません。

引数として、設定したいミリ秒の値を数値で指定します。この値は0から999までの範囲で設定するのが一般的ですが、範囲外の値を指定することも可能です。例えば、1000を指定すると、ミリ秒は0となり、秒が1繰り上がって自動的に日付が調整されます。また、負の値を指定した場合も同様に、前の秒や分などに調整されます。

このメソッドは、ミリ秒が設定された後のDateオブジェクトを表す、Unix Epoch（1970年1月1日00:00:00 UTC）からの経過時間をミリ秒単位で返します。主に、特定の時間要素（ミリ秒）をUTC基準で厳密に操作したい場合に利用されます。例えば、システムのログ記録や、国際的なイベントの時刻合わせなど、タイムゾーンの影響を受けずに時刻を扱いたい場面で有効です。

Dateオブジェクトの時刻要素を操作する多くのメソッドの一つであり、ローカルタイムゾーンで動作するDate.prototype.setMilliseconds()とは異なり、常にUTC基準で動作する点が大きな特徴です。これにより、異なる地理的場所にいるユーザー間でも、一貫した時間操作が可能になります。

Copy
1const dateObj = new Date();
2dateObj.setUTCMilliseconds(500);

millisecondsValue

• millisecondsValue: number: UTC で設定するミリ秒を指定する数値

Number

このメソッドは、指定されたUTC（協定世界時）のミリ秒値を設定した後の、Dateオブジェクトのタイムスタンプ（1970年1月1日午前0時からのミリ秒数）を数値で返します。