【JavaScript ECMAScript】Temporal::Temporal.Instant.fromEpochMilliseconds静的メソッドの使い方
Temporal.Instant.fromEpochMilliseconds()静的メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.Instant.fromEpochMilliseconds()メソッドは、エポックミリ秒値を受け取り、それを協定世界時（UTC）の特定の一時点を表すTemporal.Instantオブジェクトに変換して生成するメソッドです。
Temporal.Instantは、特定のタイムゾーンやカレンダーシステムに依存しない、絶対的な時間の一時点を正確に表現するためのオブジェクトです。エポックミリ秒とは、協定世界時（UTC）の1970年1月1日00:00:00からの経過ミリ秒数を示す数値で、これは多くのシステムで共通の時間表現として広く用いられます。
このメソッドは、そうした数値形式のエポックミリ秒を引数として受け取り、より厳密で柔軟な時間操作を可能にするTemporal.Instantオブジェクトに変換します。これにより、異なるシステムやAPIから取得したエポックミリ秒値から、タイムゾーンの影響を受けずに正確な時刻情報を簡単に復元し、Temporal APIの豊富な機能を用いて時間計算やフォーマットを行うことが可能になります。時間のデータが持つ意味を一貫して保持し、システム間での時間情報の相互運用性や信頼性を高める上で非常に有用です。
公式リファレンス: Temporal.Instant.fromEpochMilliseconds()
構文(syntax)
1const instant = Temporal.Instant.fromEpochMilliseconds(epochMilliseconds);
引数(parameters)
epochMilliseconds
- epochMilliseconds: number: エポックミリ秒単位の整数値。0は1970年1月1日午前0時0分0秒UTCを表します。
戻り値(return)
Temporal.Instant
指定されたミリ秒数で表されたエポックタイムから、新しい Temporal.Instant オブジェクトを生成して返します。