Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

Temporal.Instant.prototype.toString()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Temporal.Instant.prototype.toString()メソッドは、Temporal.Instantオブジェクトが表す絶対的な時点の情報を、標準的なISO 8601形式の文字列に変換して出力するメソッドです。Temporal.Instantは、タイムゾーンに依存せず、エポックからの経過時間をナノ秒精度で保持します。このメソッドを使うことで、オブジェクトの時刻情報を人間が読みやすい形式で取得でき、デバッグ、ログ出力、または日時情報の文字列としての受け渡しなど、様々な用途で活用できます。

引数なしでこのメソッドを呼び出すと、出力文字列はUTC(協定世界時)に基づき、「YYYY-MM-DDTHH:mm:ss.nnnnnnnnnZ」という形式になります。年月日、時分秒、ナノ秒までの小数部、そしてUTCを示す'Z'が組み合わされます。この標準フォーマットは、異なるシステム間での日時情報の整合性確保に役立ちます。

また、toString()メソッドはオプションの引数を受け入れ、出力される秒の小数部の桁数(fractionalSecondDigits)や、表示したいタイムゾーン(timeZone)を細かく調整できます。これにより、特定の要件に合わせた日時文字列を柔軟に生成可能です。Temporal.Instantオブジェクトの値を表現する、非常に便利な機能です。

公式リファレンス: Temporal.Instant.prototype.toString()

構文(syntax)

1temporalInstantInstance.toString(options);

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

このメソッドは、Temporal.Instantオブジェクトの文字列表現を返します。これは、RFC 3339形式で表される時間点(例: "1994-11-05T08:15:30-07:00[America/Los_Angeles]")です。

関連コンテンツ

関連プログラミング言語