【Node.js24.x】Number::toLocaleString()メソッドの使い方
toLocaleStringメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
toLocaleStringメソッドは、Number オブジェクトの値を、言語や地域の慣習に合わせた形式の文字列に変換して返すメソッドです。このメソッドは、数値データの表示を国際化（i18n）に対応させる際に非常に重要な役割を果たします。
具体的には、数値をユーザーが理解しやすいように、地域に応じた桁区切り文字を自動で挿入したり、小数点以下の表示桁数を調整したり、通貨形式やパーセンテージ形式で表現したりする機能を提供します。表示形式は、メソッドに渡す locales 引数と options 引数によって細かく制御可能です。
locales 引数には、例えば 'en-US'（米国英語）や 'ja-JP'（日本）といったロケール識別子を指定でき、これにより数値の区切り記号（カンマやピリオドなど）や、通貨記号の位置などが自動的に適用されます。options 引数では、style プロパティで 'decimal'（通常の数値）、'currency'（通貨）、'percent'（パーセンテージ）などを指定したり、currency プロパティでISO 4217通貨コード（例: 'JPY'、'USD'）を指定したりして、より具体的な表示形式を定義できます。
このように、toLocaleString メソッドは、システムが世界中のユーザーに数値データを分かりやすく提示するために不可欠な機能であり、開発者が各地域の文化的な数値表現の違いを意識することなく、統一された方法で多様な表示を実現することを可能にします。
構文(syntax)
1const myNumber = 123456.789; 2myNumber.toLocaleString('en-US', { style: 'currency', currency: 'USD' });
引数(parameters)
locales, options
- locales: string | string[] | undefined: 書式設定に使用するロケール（言語・地域）を指定します。指定しない場合は、実行環境のデフォルトロケールが使用されます。
- options: object | undefined: 数値の書式設定に関する詳細なオプションを指定します。
戻り値(return)
string
指定されたロケール（地域設定）に基づいた、数値の文字列表現を返します。