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

Temporal.PlainDate.prototype.toString()メソッドは、Temporal.PlainDateオブジェクトが保持する日付情報を、国際標準の日付表記形式であるISO 8601形式の文字列として表現するメソッドです。

Temporal.PlainDateオブジェクトは、年、月、日の情報のみを持ち、タイムゾーンやUTCからのオフセットといった時間に関する情報を一切含みません。このメソッドを呼び出すと、例えば「2023-10-27」のように、YYYY-MM-DD形式で整形された日付文字列が生成されます。引数を渡す必要はなく、常に一貫した形式で日付の文字列表現を得ることができます。

このメソッドは、Temporal.PlainDateオブジェクトのデータ内容を、人間が直感的に理解しやすく、また他のシステムとの連携においても誤解が生じにくい標準的な形式で表示したい場合に特に有用です。例えば、アプリケーションのログに日付を記録する際や、ユーザーインターフェースに日付を表示する際、あるいは日付データをAPI経由でやり取りする際に活用されます。

ISO 8601形式は世界中で広く採用されている日付と時刻の表現方法であるため、このtoString()メソッドによって得られる文字列は、異なる地域やシステム間での日付情報の交換を円滑に進める手助けとなります。JavaScriptの新しい日付・時刻APIであるTemporalの一部として、日付の操作や表現をより堅牢かつ分かりやすくするための基本的な機能として提供されています。このメソッドを利用することで、開発者は複雑な日付整形ロジックを自身で記述する手間を省き、プログラムの可読性と保守性を高めることができます。

Copy
1const plainDate = new Temporal.PlainDate(2023, 10, 26);
2const dateString = plainDate.toString();
3console.log(dateString);

options

• options: Temporal.PlainDate.prototype.toString() の出力フォーマットをカスタマイズするためのオプションオブジェクト

string

このメソッドは、日付オブジェクトをISO 8601形式（例: "2023-10-27"）の文字列として返します。