【Node.js24.x】Date::toLocaleTimeString()メソッドの使い方
toLocaleTimeStringメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
toLocaleTimeStringメソッドは、Dateオブジェクトに格納されている日付と時刻の情報のうち、時刻の部分を、指定されたロケール（地域や言語）に合わせた形式の文字列に変換して返すメソッドです。
このメソッドは、国際化されたアプリケーションにおいて、ユーザーのいる地域や設定された言語に応じて時刻の表示形式を適切に調整したい場合に非常に役立ちます。引数として、まず一つ目にロケールをBCP 47言語タグの形式で指定できます。例えば、「ja-JP」は日本語（日本）、「en-US」は英語（米国）を表します。この引数を省略した場合、実行環境のデフォルトのロケールが使用されます。
二つ目の引数には、時刻の表示形式を細かく制御するためのオプションオブジェクトを指定できます。例えば、hour, minute, secondプロパティでそれぞれ表示形式（numericや2-digitなど）を指定したり、timeZoneプロパティでタイムゾーンを指定したりすることが可能です。これにより、同じ時刻情報からでも、「午前9時30分00秒」、「9:30:00 AM」、「09:30:00」といった、地域や用途に合わせた多様な表現を得ることができます。
このメソッドは、Dateオブジェクト全体ではなく、その時刻部分のみに焦点を当てて文字列変換を行います。システムエンジニアの初心者の皆さんが、地域設定に合わせた日付時刻表示を扱う際に、このメソッドの基本的な機能と使い方を理解しておくことは、多言語対応のアプリケーション開発において非常に重要です。
構文(syntax)
1new Date().toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', second: '2-digit' });
引数(parameters)
locales = undefined, options = undefined
- locales: string | string[] | undefined: 時間の表記に使用するロケールを指定します。指定しない場合は、実行環境のデフォルトロケールが使用されます。
- options: Intl.DateTimeFormatOptions | undefined: 時間の表記方法をカスタマイズするためのオプションオブジェクトを指定します。
戻り値(return)
string
指定されたロケール（地域設定）とオプションに基づいて、Dateオブジェクトの時刻部分を文字列として返します。