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

Temporal.PlainMonthDay.prototype.toJSON()メソッドは、Temporal.PlainMonthDayオブジェクトが保持する月と日の情報を、JSON（JavaScript Object Notation）形式に対応した文字列として表現するメソッドです。このメソッドは、Temporal.PlainMonthDayオブジェクトのデータを、ネットワーク経由で送信したり、ファイルに保存したりする際に、標準的な文字列形式に変換するために使用されます。

具体的には、このメソッドはPlainMonthDayオブジェクトが持つ月と日の値を、ISO 8601拡張フォーマットに準拠した文字列（例: --11-20）で返します。この形式は、特定の年やタイムゾーンに関する情報を含まず、純粋に月と日のみを表現します。例えば、11月20日を表すPlainMonthDayインスタンスがある場合、toJSON()メソッドを呼び出すと"--11-20"という文字列が得られます。

JavaScriptの標準機能であるJSON.stringify()関数は、オブジェクトをJSON文字列に変換する際に、もしそのオブジェクトにtoJSON()メソッドが存在すれば、そのメソッドを自動的に呼び出します。そのため、PlainMonthDayオブジェクトをJSON.stringify()でシリアライズすると、このtoJSON()メソッドが提供するISO 8601形式の文字列が結果として得られます。これにより、異なるシステム間でのデータ連携が容易になり、日付の情報を一貫した形式で安全に扱うことが可能になります。システムエンジニアを目指す方にとって、日付や時刻のデータを正しく扱うことは非常に重要であり、このメソッドはその基盤となる役割を担っています。

Copy
1plainMonthDay.toJSON()

引数なし

引数はありません

string

このメソッドは、PlainMonthDayオブジェクトの情報をJSON文字列形式で返します。