【Node.js24.x】Date::toJSON()メソッドの使い方
toJSONメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
toJSONメソッドは、Dateオブジェクトの値をJSON形式に適した文字列に変換するメソッドです。このメソッドは、日付と時刻の情報を、国際標準であるISO 8601形式の文字列として表現します。具体的には、「YYYY-MM-DDTHH:mm:ss.sssZ」のように、日付、時刻、ミリ秒、そしてUTC（協定世界時）を示す「Z」を含む形式で出力されます。
JSON（JavaScript Object Notation）は、データをやり取りするための軽量なフォーマットですが、日付型を直接サポートしていません。そのため、DateオブジェクトをJSONに含める際には、このtoJSONメソッドが自動的に呼び出され、誰もが理解できる標準的な文字列形式に変換されます。
特に、Node.jsでJSON.stringify()関数を使ってDateオブジェクトを含むデータをJSON形式の文字列に変換する際、このtoJSONメソッドが内部で利用されます。これにより、開発者はDateオブジェクトを特別な処理なしにJSON.stringify()に渡すだけで、自動的に適切な日付文字列に変換されたJSONデータを得ることができます。このメソッドにより、異なるシステム間での日付データの互換性が向上し、安全かつ正確なデータ交換を実現します。
構文(syntax)
1const date = new Date(); 2const isoString = date.toJSON(); 3console.log(isoString);
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
このtoJSONメソッドは、DateオブジェクトをJSON形式で表現した文字列を返します。この文字列はISO 8601形式に準拠した日付と時刻を表しています。