【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.toJSONインスタンスメソッドの使い方
Temporal.ZonedDateTime.prototype.toJSON()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Temporal.ZonedDateTime.prototype.toJSON()メソッドは、Temporal.ZonedDateTimeオブジェクトが保持するタイムゾーン付きの日時情報を、標準的なJSON形式で表現できる文字列に変換して返すメソッドです。
Temporal.ZonedDateTimeオブジェクトは、特定の日時、タイムゾーン、およびUTCからのオフセットを厳密に管理するJavaScriptの新しい日付時刻APIの一部です。このメソッドは、このような複雑な日時情報を、他のシステムやアプリケーションと交換しやすい簡潔な形式に変換する役割を担っています。具体的には、国際的に広く認知されているISO 8601形式の文字列として日時情報を出力します。この形式は、日付と時刻、そしてタイムゾーン情報を一貫した方法で表現するためによく使用されます。
このtoJSON()メソッドは、JavaScriptの標準機能であるJSON.stringify()関数と組み合わせて使用されることを想定しています。JSON.stringify()がTemporal.ZonedDateTimeオブジェクトを検出すると、自動的にこのtoJSON()メソッドを呼び出し、その戻り値であるISO 8601形式の文字列をJSONデータの一部として含めます。これにより、開発者はTemporal.ZonedDateTimeオブジェクトをそのままJSON形式にシリアライズでき、ウェブAPIを介したデータの送受信や、設定ファイルの保存といった場面で、正確かつ信頼性の高い日時情報の取り扱いが可能となります。
構文(syntax)
1myZonedDateTime.toJSON();
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
このメソッドは、Temporal.ZonedDateTimeオブジェクトをJSON形式の文字列に変換したものを返します。この文字列は、日付、時刻、およびタイムゾーン情報を含んでいます。