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

Temporal.PlainTime.prototype.toJSON()メソッドは、Temporal.PlainTimeオブジェクトをJSON形式に適した文字列に変換して返すメソッドです。このメソッドは、Temporal.PlainTimeインスタンスが保持する「時刻」の情報を、国際標準であるISO 8601形式の文字列として表現するために使用されます。特に、JavaScriptのJSON.stringify()関数にTemporal.PlainTimeオブジェクトを渡してJSON形式の文字列にシリアライズする際、このtoJSON()メソッドが自動的に呼び出されます。

Temporal.PlainTimeオブジェクトは、特定のタイムゾーンや日付に依存しない純粋な時刻（例えば、「午後3時30分」といった情報）を表します。toJSON()メソッドを呼び出すと、その時刻情報が"HH:MM:SS.fractionalSeconds"（時、分、秒、および必要に応じて小数秒）の形式に整形された文字列として出力されます。これにより、データベースへの保存、APIを介したデータ送信、またはログ記録など、さまざまな場面でPlainTimeオブジェクトの時刻データを標準的かつ一貫した方法で扱うことが可能になります。

例えば、午前10時30分を表すTemporal.PlainTimeインスタンスに対してこのメソッドを呼び出すと、"10:30:00"のような文字列が返されます。この機能は、Temporal APIが提供する正確で国際化された日付・時刻処理の利便性を高め、システムエンジニアが時刻データを効率的に管理するための重要な手段となります。

Copy
1const plainTime = new Temporal.PlainTime(12, 30);
2plainTime.toJSON();

引数なし

引数はありません

string

Temporal.PlainTime.prototype.toJSON() は、JavaScriptのTemporal APIにおけるPlainTimeオブジェクトをJSON形式の文字列に変換したものを返します。この文字列は、ISO 8601形式の時間表現に基づいています。