【JavaScript ECMAScript】Date::Date.prototype.toJSONインスタンスメソッドの使い方
Date.prototype.toJSON()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Date.prototype.toJSON()メソッドは、JavaScriptのDateオブジェクトの値を、JSON (JavaScript Object Notation) 形式で表現するのに適した文字列に変換するメソッドです。このメソッドは、特定の日付と時刻を、国際標準であるISO 8601形式の文字列として出力します。具体的には、"YYYY-MM-DDTHH:mm:ss.sssZ"のような形式で、年は4桁、月日は2桁、時刻は時分秒ミリ秒までがそれぞれ2桁または3桁で表現され、末尾の"Z"は協定世界時(UTC)であることを示します。
このメソッドの主な目的は、DateオブジェクトをJSON.stringify()メソッドを使って文字列に変換する際に、一貫した標準的な形式を提供することです。JSON.stringify()がDateオブジェクトを検出すると、内部的にtoJSON()メソッドを呼び出し、その結果得られたISO 8601形式の文字列をJSON出力に含めます。
システム開発において、異なるシステム間で日付や時刻の情報を交換する際には、形式の統一が非常に重要です。Date.prototype.toJSON()メソッドは、この統一された形式を自動的に提供するため、サーバーとクライアント間でのデータ送受信や、データベースへの日付データの保存など、様々なシナリオでデータの整合性を保ち、開発者が意図しない形式の違いによる問題を避けるのに役立ちます。これにより、日付情報の信頼性と互換性が向上します。
構文(syntax)
1const dateInstance = new Date(); 2const isoString = dateInstance.toJSON();
引数(parameters)
引数なし
引数はありません
戻り値(return)
String
このメソッドは、DateオブジェクトをJSON形式の文字列に変換したものを返します。