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

Intl.NumberFormat.prototype.resolvedOptions()メソッドは、Intl.NumberFormatオブジェクトが数値の書式設定を行う際に、実際に適用されている最終的な書式設定オプションを新しいオブジェクトとして返すメソッドです。

Intl.NumberFormatオブジェクトは、初期化時に開発者が指定する書式設定オプション、実行環境のデフォルト設定、そしてユーザーのロケール（言語と地域）の優先順位に基づいて、数値の表示方法を決定します。このプロセスの中で、指定されたオプションは内部的に調整され、「解決」された最終的な設定が確立されます。

このresolvedOptions()メソッドは、そのようにして決定された実際に使用されているすべてのオプションを詳細に確認するために利用されます。戻り値のオブジェクトには、locale（実際に使用されているロケール）、numberingSystem（使用されている数字の体系）、style（書式設定のスタイル、例えば通貨、パーセント、小数など）、currency（通貨表示の場合の通貨コード）、minimumFractionDigits（最小小数点以下の桁数）などの情報が含まれています。

このメソッドを使用することで、開発者はIntl.NumberFormatオブジェクトが意図通りに設定されているかを検証したり、異なる環境やロケールで数値がどのように書式設定されるかを正確に把握したりすることができます。特に、国際化対応されたアプリケーションにおいて、数値の表示が期待通りに行われているかをデバッグし、確認する際に非常に役立ちます。

Copy
1const numberFormat = new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' });
2const resolvedOptions = numberFormat.resolvedOptions();

引数なし

引数はありません

Object

このメソッドは、Intl.NumberFormat オブジェクトの現在のロケールおよび書式設定オプションを表すオブジェクトを返します。