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

Intl.NumberFormat.prototype.format()メソッドは、指定された数値を、国際化された形式に基づいて整形した文字列として返すメソッドです。このメソッドは、JavaScriptのIntl.NumberFormatオブジェクトのインスタンスに対して使用され、数値の書式設定を、ユーザーのロケール（地域や言語）に合わせて行います。

たとえば、日本では「1,234.56円」と表現される数値が、ドイツでは「1.234,56 €」のように桁区切りと小数点の記号、通貨記号の位置などが異なることがあります。Intl.NumberFormat.prototype.format()メソッドは、このような国や言語による数値表示の差異を自動的に吸収し、各ロケールに最も適切な形式で数値を整形してくれます。これにより、開発者がこれらの複雑な書式設定の違いを個別に処理することなく、多言語対応のアプリケーションで国際的なユーザー体験を提供できるようになります。

具体的な使用方法としては、まずnew Intl.NumberFormat(locales, options)コンストラクタを用いて、書式設定したいロケール（例: 'ja-JP' や 'de-DE'）や、通貨の種類、パーセンテージ表示、最小・最大小数桁数などのオプションを指定してNumberFormatオブジェクトを作成します。その後、作成したNumberFormatインスタンスのformat()メソッドに、整形したい数値を引数として渡します。すると、指定されたロケールとオプションに従って整形された数値の文字列が戻り値として得られます。この機能は、グローバルなWebアプリケーションやサービスを開発する上で、ユーザーインターフェースの国際化において非常に重要な役割を果たします。

Copy
1const numberFormatter = new Intl.NumberFormat('en-US');
2const valueToFormat = 12345.678;
3numberFormatter.format(valueToFormat);

number

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

String

指定された数値を、Intl.NumberFormatオブジェクトで設定されたロケール（地域）と書式設定に従って、整形された文字列として返します。