数値を指定したロケールに応じた形式で文字列に変換する(toLocaleString)

Number オブジェクトのインスタンスメソッドである toLocaleString は、数値を指定したロケールとオプションに応じた形式で文字列に変換した値を取得することができます。国によって数値を三桁毎にカンマ(,)で区切るかドット(.)で区切るのかは違っていますが、このメソッドでロケールとして地域を指定すれば対象の数値をそのロケールに合わせて変換してくれます。ここでは Number オブジェクトの toLocaleString メソッドの使い方について解説します。

(Last modified: 2024-09-25)

ロケールに応じた文字列に変換する(toLocaleString)

Number オブジェクトの toLocaleString メソッドは、指定したロケールにあわせて対象の数値を文字列に変換した値を返します。書式は次のとおりです。

数値を引数に指定したロケールに合わせた形に変換したあと、そのあとで文字列に変換した値を返します。引数を省略した場合はデフォルトロケールが指定されたものとして扱われます。(なお 2 番目の引数であるオプションについては詳細が分かりませんでした)。

次のサンプルをみてください。

let num = 8242.56;

console.log(num.toLocaleString());
>> 8,242.56
console.log(num.toLocaleString('ja-JP'));
>> 8,242.56
console.log(num.toLocaleString('de-DE'));
>> 8.242,56
console.log(num.toLocaleString('ru-RU'));
>> 8?242,56

指定したロケールに応じて数値の表現方法が異なっています。日本(日本語)では桁の区切りにカンマ、小数点にピリオドですが、ドイツ(ドイツ語)では逆となります。またロシア(ロシア語)では桁の区切りが空白となります。(国別ではなく国と言語で異なるようです)。

なお整数のように小数点が含まれない数値に対して直接 toLocaleString メソッドを実行する場合は、数値を括弧で囲うか数値のあとに空白を追加してください。

console.log(1000.toLocaleString('ja-JP'));
>> Uncaught SyntaxError: Invalid or unexpected token

console.log((1000).toLocaleString('ja-JP')); // 数値を括弧で囲う
>> 1,000

console.log(1000 .toLocaleString('ja-JP')); // 数値のあとに空白を入れる
>> 1,000

-- --

Number オブジェクトの toLocaleString メソッドの使い方について解説しました。

著者 / TATSUO IKURA

これから IT 関連の知識を学ばれる方を対象に、色々な言語でのプログラミング方法や関連する技術、開発環境構築などに関する解説サイトを運営しています。