【JavaScript ECMAScript】Intl::Intl.DurationFormat() constructorコンストラクタの使い方
Intl.DurationFormat() constructorコンストラクタの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Intl.DurationFormat() constructorクラスは、時間、日数、分、秒などの時間の長さを表す「期間」を、特定の言語や地域の規則に基づいて整形し、人間にとって読みやすい文字列に変換するためのオブジェクトを生成するクラスです。このクラスは、JavaScriptの国際化API（Intlオブジェクト）の一部として提供されており、ウェブアプリケーションやシステムにおいて、世界中の多様な言語や文化圏のユーザーに対して期間の表示形式を適切に調整する機能を提供します。
例えば、カウントダウンタイマーやイベントの残り時間、タスクの完了までの所要時間などを表示する際に、「1時間30分」という期間の数値を、ユーザーの言語設定に応じて「1 hour, 30 minutes」（英語）や「1時間30分」（日本語）のように適切な形式で表示できます。このコンストラクタを呼び出すことで、新しいDurationFormatオブジェクトが作成され、そのオブジェクトのメソッドを使って期間データを整形することが可能になります。
引数には、表示する言語や地域を指定するロケール文字列や、表示単位（年、月、日、時間、分、秒など）や数値の表示スタイルなどを細かく制御するためのオプションオブジェクトを渡すことができます。これにより、システムエンジニアは、国際化されたアプリケーションで期間情報を正確かつユーザーフレンドリーに表現することが可能になります。
公式リファレンス: Intl.DurationFormat() constructor
構文(syntax)
1new Intl.DurationFormat([locales[, options]])
引数(parameters)
locales, options
- locales: string | string[] | undefined: フォーマットに使用するロケール（言語と地域）を指定します。省略した場合、実行環境のデフォルトロケールが使用されます。
- options: Intl.DurationFormatOptions | undefined: フォーマットの動作をカスタマイズするためのオプションオブジェクトです。
戻り値(return)
戻り値なし
戻り値はありません