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

Temporal.PlainDateTime.prototype.toJSON()メソッドは、JavaScriptのTemporal APIにおけるPlainDateTimeオブジェクトを、JSON形式のデータとしてシリアライズ（変換）する際に、そのオブジェクトの標準的な文字列表現を提供するメソッドです。このメソッドは、通常、JavaScriptの組み込み関数であるJSON.stringify()がTemporal.PlainDateTimeインスタンスを処理する際に自動的に呼び出されます。

具体的には、PlainDateTimeオブジェクトが保持する年、月、日、時、分、秒などの日付と時刻の情報が、国際標準規格であるISO 8601形式に準拠した文字列として出力されます。例えば、「2023-10-27T10:30:00」のような形式でデータを表現します。

この機能により、Temporal.PlainDateTimeオブジェクトが持つ日付と時刻のデータを、他のシステムやアプリケーションとの間で交換したり、ファイルとして保存したりする際に、一貫性のある標準的な形式で取り扱うことが可能になります。開発者がこのメソッドを直接呼び出すことは稀ですが、JSONデータ変換時にTemporalオブジェクトが正確に文字列化されることを保証する、データ連携において非常に重要な役割を担っています。

Copy
1const plainDateTime = new Temporal.PlainDateTime(2023, 1, 1, 12, 0, 0);
2const jsonString = plainDateTime.toJSON();

引数なし

引数はありません

string

Temporal.PlainDateTime.prototype.toJSON() は、Temporal.PlainDateTime オブジェクトを、JSON 文字列として表現可能な形式に変換した結果を返します。これは ISO 8601 形式に準拠した文字列となります。