【JavaScript ECMAScript】Temporal::Temporal.Instant.prototype.epochMillisecondsインスタンスアクセサプロパティの使い方

Temporal.Instant.prototype.epochMillisecondsプロパティは、JavaScriptのTemporal APIにおいて、特定の一瞬を表すTemporal.Instantオブジェクトが、Unixエポック（1970年1月1日00:00:00 UTC）からどれだけのミリ秒が経過したかを示す数値を保持する読み取り専用のプロパティです。

このプロパティは、Temporal.Instantオブジェクトの各インスタンスに備わっており、そのインスタンスが表現する絶対的な時間値を、特定のタイムゾーンやカレンダーシステムに影響されない、普遍的な数値形式で提供します。取得される数値は、エポックより後の時刻であれば正の値、エポックより前の時刻であれば負の値となります。

システムエンジニアの皆様にとって、異なる時間表現の間で厳密な比較を行いたい場合や、特定の時点を国際的に一貫した数値で扱いたい場合に非常に有用です。例えば、パフォーマンス測定やログのタイムスタンプ、あるいは分散システム間での時刻同期など、精度の高い時間情報が必要な場面で、このプロパティを用いてミリ秒単位の絶対時間を容易に取得できます。これにより、時間に関する複雑な変換処理を簡素化し、より堅牢なシステム構築に貢献します。

Copy
1const instant = Temporal.Instant.now();
2const epochMillisecondsValue = instant.epochMilliseconds;

引数なし

引数はありません

number

この epochMilliseconds プロパティは、Temporal.Instant オブジェクトが表す時点から、UNIX エポック（1970年1月1日 00:00:00 UTC）までの経過時間をミリ秒単位で返します。