【JavaScript ECMAScript】Intl::Intl.NumberFormat.prototype.formatToPartsインスタンスメソッドの使い方

Intl.NumberFormat.prototype.formatToParts()メソッドは、指定された数値を国際化された書式で文字列に整形した際に、その文字列を構成する各部分に分解して取得するメソッドです。JavaScriptのIntl.NumberFormatオブジェクトは、数値を通貨、パーセンテージ、単位など、地域や言語に応じた適切な形式で表示するために使用されます。このformatToParts()メソッドは、整形された数値全体を一つの文字列として返すformat()メソッドとは異なり、例えば「$1,234.56」という文字列を「通貨記号」「整数部」「グループ区切り記号」「小数部」「小数点」といった個々の要素に分割して扱えるようにします。

戻り値は、各部分の情報を保持するオブジェクトの配列です。それぞれのオブジェクトには、その部分の種類を示すtypeプロパティ（例: "currency", "integer", "fraction", "group"など）と、その部分の実際の文字列値を示すvalueプロパティが含まれます。これにより、整形された数値の特定の箇所にのみスタイルを適用したり、特定の要素に基づいて異なる処理を行ったりするような、より柔軟な表示制御や処理が可能になります。システム開発において、国際対応された数値表示で、詳細なカスタマイズが必要な場合に特に有用です。

Copy
1const numberFormatter = new Intl.NumberFormat('en-US', { style: 'decimal' });
2const partsArray = numberFormatter.formatToParts(12345.678);

number

• number: number: フォーマットする数値を指定します

Array<Object>

指定された数値のフォーマットを、各部分（記号、数字、単位など）に分割したオブジェクトの配列として返します。