【JavaScript ECMAScript】Temporal::Temporal.Instant.fromEpochNanoseconds静的メソッドの使い方
Temporal.Instant.fromEpochNanoseconds()静的メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Temporal.Instant.fromEpochNanoseconds()メソッドは、指定されたナノ秒単位のエポックからの経過時間をもとに、不変のTemporal.Instantオブジェクトを作成し返却するメソッドです。
Temporal.Instantは、特定のタイムゾーンやカレンダーに依存せず、絶対的な時間点（瞬間）を表すオブジェクトです。このメソッドは、1970年1月1日UTCを基準とする「エポック」と呼ばれる時刻から、引数として渡されたナノ秒数だけが経過した瞬間を正確に表現するTemporal.Instantインスタンスを生成します。
引数には、BigInt型でエポックからの経過ナノ秒数を指定します。JavaScriptの標準的なnumber型では表現できないほどの非常に大きな数値や、高い精度が求められる時間を正確に扱うためにBigIntが用いられています。これにより、ナノ秒単位の極めて詳細な時刻情報も正確に保持できます。
このメソッドはTemporal.Instantクラスの静的メソッドとして提供されており、new Temporal.Instant()のようにインスタンスを生成することなく、Temporal.Instant.fromEpochNanoseconds(epochNanoseconds)のようにクラス名から直接呼び出して使用します。高精度のタイムスタンプが必要なシステムログや、異なるタイムゾーン間で純粋な時間比較を行う際など、絶対的な時間点を厳密に扱う場合に特に有用です。
構文(syntax)
1const epochNanoseconds = 1678886400000000000n; // エポックからのナノ秒を表すBigInt 2const instant = Temporal.Instant.fromEpochNanoseconds(epochNanoseconds);
引数(parameters)
epochNanoseconds
- epochNanoseconds: number: エポック（1970年1月1日 00:00:00 UTC）からの経過時間をナノ秒単位で指定する数値
戻り値(return)
Temporal.Instant
指定されたナノ秒単位の正確な時刻を表す Temporal.Instant オブジェクトを返します。