【JavaScript ECMAScript】Temporal::Temporal.Instant.prototype.toJSONインスタンスメソッドの使い方

Temporal.Instant.prototype.toJSON()メソッドは、JavaScriptのTemporal.Instantオブジェクトが表す特定の瞬間を、標準的なJSON形式の文字列に変換して返すメソッドです。Temporal.Instantは、UNIXエポックからの経過時間をナノ秒精度で表現するオブジェクトであり、特定のタイムゾーンに依存しない「時点」を表します。このtoJSON()メソッドを呼び出すと、そのTemporal.Instantオブジェクトが表す瞬間は、ISO 8601形式に準拠したUTC（協定世界時）の日時文字列として出力されます。具体的には、「YYYY-MM-DDTHH:mm:ss.sssZ」のような形式で、末尾の「Z」はUTCであることを示します。

このメソッドの主な目的は、JSON.stringify()関数がTemporal.Instantオブジェクトを適切にシリアライズできるようにすることです。これにより、Temporal.Instantオブジェクトをデータベースに保存したり、APIを通じて他のシステムに送信したりする際に、一貫性のあるテキスト形式でデータを安全に扱えます。システムエンジニアが日付と時刻の情報を異なるシステム間で確実かつ標準的な方法で交換する場面で、このメソッドは非常に役立ちます。Temporal.Instantオブジェクト自体はタイムゾーン情報を持たないため、このtoJSON()メソッドが常にUTCでの表現を返す点に注意が必要です。特定のタイムゾーンにおける日時表現が必要な場合は、Temporal.ZonedDateTimeオブジェクトのtoJSON()メソッドを利用するか、別途適切な変換処理を行う必要があります。この機能により、複雑な日時処理をより正確かつ標準的に行えるようになります。

Copy
1const instant = Temporal.Instant.from("2023-10-27T10:00:00Z");
2const jsonString = instant.toJSON();

引数なし

引数はありません

string

このメソッドは、Instant オブジェクトを JSON 文字列として表現したものを返します。この文字列は、ISO 8601 形式の日時を表します。