【JavaScript ECMAScript】Temporal::Temporal.Instantコンストラクタの使い方
Temporal.Instant()コンストラクタの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.Instant()クラスは、特定のタイムゾーンやカレンダーに依存しない、単一の明確な時点（瞬時）を表すクラスです。これは、JavaScriptの新しい日付時刻APIであるTemporal APIの一部として提供されています。Temporal.Instantは、協定世界時（UTC）の1970年1月1日00:00:00からのナノ秒数で時間を表現するため、タイムゾーンや夏時間（DST）の概念を一切持ちません。これにより、世界中のどの場所でも常に同じ絶対的な瞬間を指し示すことができ、異なる地域間での時刻の比較や、システム内部での一貫した時刻管理に非常に適しています。
このクラスの主な目的は、時間的な瞬間を曖昧さなく扱うことにあります。例えば、データベースに保存するタイムスタンプや、イベントの発生時刻などを正確に記録する際に役立ちます。Temporal.Instantのインスタンスは、通常、Temporal.Instant.from()のような静的ファクトリメソッドや、現在の瞬間を取得するTemporal.Now.instant()メソッドなどを用いて作成されます。直接new演算子でコンストラクタを呼び出す方法は非推奨であり、通常は推奨されません。Temporal.Instantを活用することで、開発者はタイムゾーンの変換やオフセットの計算といった複雑な問題に悩まされることなく、より信頼性の高い日付時刻処理をアプリケーションに実装できるようになります。
公式リファレンス: Temporal.Instant()
構文(syntax)
1new Temporal.Instant("2023-10-27T10:00:00Z");
引数(parameters)
epochNanoseconds
- epochNanoseconds: number: 協定世界時 (UTC) の 1970 年 1 月 1 日 00:00:00 から経過したナノ秒数を表す数値
戻り値(return)
戻り値なし
戻り値はありません