【JavaScript ECMAScript】Temporal::Temporal.PlainDateTime.prototype.toStringインスタンスメソッドの使い方
Temporal.PlainDateTime.prototype.toString()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainDateTime.prototype.toString()メソッドは、JavaScriptの新しいTemporal APIにおいて、タイムゾーン情報を持たない特定の日付と時刻を表すTemporal.PlainDateTimeオブジェクトの内容を、標準的なISO 8601形式の文字列に変換して返すメソッドです。このメソッドは、Temporal.PlainDateTimeのインスタンスに対して呼び出され、そのインスタンスが保持する年、月、日、時、分、秒、ミリ秒などの詳細な日時情報を、一貫性のある書式で表現します。
具体的には、PlainDateTimeオブジェクトが保持するカレンダー日付と時刻のデータを、例えば「2023-10-27T10:30:00.123」のような形式の文字列として出力します。この変換機能は、プログラムのデバッグ時やログ出力、ユーザーインターフェースでの日付時刻の表示など、様々な場面で非常に役立ちます。タイムゾーンの概念を含まない「純粋な」カレンダー上の日時として文字列化されるため、異なるタイムゾーンを意識せず、カレンダー上の同じ日時を指し示す目的でのデータ表現に適しています。これにより、データの視認性が向上し、外部システムとのデータ連携時における日付時刻形式の統一にも貢献します。
構文(syntax)
1const plainDateTimeInstance = new Temporal.PlainDateTime(2023, 10, 26, 10, 30, 0, 0, 0, 0); 2plainDateTimeInstance.toString();
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
このメソッドは、Temporal.PlainDateTimeオブジェクトの値を、ISO 8601形式の文字列として返します。