【JavaScript ECMAScript】Intl::Intl.NumberFormat.prototype.formatRangeToPartsインスタンスメソッドの使い方
Intl.NumberFormat.prototype.formatRangeToParts()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Intl.NumberFormat.prototype.formatRangeToParts()メソッドは、指定された二つの数値を国際化された形式で範囲として書式設定し、その結果を個々の部分（parts）に分解した配列として返すメソッドです。
このメソッドは、まずIntl.NumberFormatオブジェクトのインスタンスに対して呼び出されます。Intl.NumberFormatは、ユーザーのロケール（地域や言語）や指定されたオプションに基づいて、数値の表示形式（通貨記号、小数点、桁区切り、単位など）を調整する機能を提供します。
formatRangeToParts()メソッドは、範囲の最小値と最大値を表す二つの数値を受け取ります。これらの数値は、設定されたロケールとオプションに従って一つの連続した範囲として書式設定されます。例えば、「1から5」という数値を「1 – 5」や、通貨として「$1.00 – $5.00」のように表現します。
このメソッドの最大の特徴は、書式設定された結果が単一の文字列ではなく、その書式を構成する各要素（数値部分、単位、区切り記号、スペースなど）が、それぞれの型（type）と値（value）を持つオブジェクトとして格納された配列で返される点です。これにより、アプリケーションは書式設定された数値範囲の個々の要素にプログラムでアクセスし、柔軟にカスタマイズした表示を実装できます。例えば、特定の数値部分だけ色を変えたり、区切り記号に独自の装飾を加えたりするといった詳細な制御が可能になります。国際的なアプリケーションで数値範囲を多様な方法で表示する必要がある場合に、特に役立つ機能です。
構文(syntax)
1const numberFormatter = new Intl.NumberFormat('en-US'); 2const parts = numberFormatter.formatRangeToParts(100, 200);
引数(parameters)
start, end
- start: number: フォーマットする範囲の開始値を指定する数値
- end: number: フォーマットする範囲の終了値を指定する数値
戻り値(return)
Array<object>
指定された範囲の数値フォーマット結果を、各部分（数値、通貨記号、区切り文字など）に分割したオブジェクトの配列として返します。