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

Temporal.Duration.prototype.toJSON()メソッドは、Temporal.DurationオブジェクトをJSON形式に変換する際に、そのオブジェクトの標準的な文字列表現を生成するメソッドです。JavaScriptのTemporal APIは、日付と時刻の複雑な操作をよりシンプルかつ堅牢に行うために導入されたオブジェクト群であり、Durationはその中でも特定の期間の長さを表現します。このtoJSON()メソッドは、Durationオブジェクトが保持する年、月、週、日、時間、分、秒などの時間の長さを、国際標準であるISO 8601 Duration形式の文字列として出力します。

たとえば、「2時間30分」を表すDurationオブジェクトがある場合、このメソッドは "PT2H30M" のような形式の文字列を返します。これにより、Temporal.Durationオブジェクトをファイルに保存したり、ネットワークを介して他のシステムへ送受信したりする際に、共通の理解しやすい形式でデータをやり取りできます。JSON.stringify()関数がTemporal.Durationオブジェクトをシリアライズする際、内部的にこのtoJSON()メソッドが呼び出され、標準的な文字列形式に自動的に変換されます。この機能により、プログラマはTemporal.Durationオブジェクトを意識することなく、安全かつ簡潔にJSONデータとして扱うことが可能になります。

Copy
1const durationInstance = Temporal.Duration.from({ hours: 1, minutes: 30 });
2const jsonRepresentation = durationInstance.toJSON();

引数なし

引数はありません

string

このメソッドは、Temporal.DurationオブジェクトをJSON文字列形式に変換した値を返します。