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

Temporal.Duration.prototype.toString()メソッドは、Temporal.Durationオブジェクトが表現する時間的な期間情報を、標準的な文字列形式に変換して返します。このメソッドの主な目的は、オブジェクト内に格納されている年、月、週、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒といった期間の各要素を、人間が読みやすく、かつ他のシステムやプログラムで容易に解析できる統一された形式で表現することです。

具体的には、国際標準化機構（ISO）によって定められたISO 8601期間形式に基づいた文字列を生成します。例えば、Temporal.Duration.from({ years: 1, months: 2, days: 3, hours: 4 })のような期間を持つDurationオブジェクトに対してtoString()を呼び出すと、「P1Y2M3DT4H」といった形式の文字列が返されます。ここで、「P」は期間（Period）、「Y」は年（Year）、「M」は月（Month）、「D」は日（Day）を表し、「T」は時間要素の開始を示し、「H」は時（Hour）を表します。

このメソッドは、デバッグ時や、アプリケーションのユーザーインターフェースに期間を表示する際、あるいは期間情報をファイルやネットワーク経由で他のアプリケーションに渡す必要がある場合に特に役立ちます。出力される文字列は常に一貫した形式であり、Temporal.Durationオブジェクトの内部状態を変更することはありません。このように、toString()メソッドは、Temporal.Durationオブジェクトの値を外部に安全かつ明確に表現するための重要な手段として機能します。

Copy
1const temporalDurationInstance = Temporal.Duration.from({ hours: 1, minutes: 30 });
2const durationIsoString = temporalDurationInstance.toString();

引数なし

引数はありません

String

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