Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【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形式の文字列として返します。

関連コンテンツ

関連プログラミング言語