JavaScript Number toLocaleString() メソッド

定義と使用法

toLocaleString() ローカル言語フォーマットを使用して数字を文字列として返します。

言語フォーマットは、コンピュータ上のローカル設定に依存しています。

インスタンス

例 1

ローカル設定を使用して数字を文字列に形式化します：

let num = 1000000;
let text = num.toLocaleString();

自分で試してみる

例 2

フィンランドの特定の言語環境を使用して数字を文字列に形式化します：

let num = 1000000;
let text = num.toLocaleString("fi-FI");

自分で試してみる

例 3

アメリカの特定の言語環境を使用して数字を通貨文字列に形式化します：

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

自分で試してみる

例4

使用 options オブジェクト（パラメータ）を使用して貨幣形式をフォーマットする：

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

自分で試してみる

例5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

自分で試してみる

例6

JAPANの特定の言語環境を使用する：

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

自分で試してみる

文法

number.toLocaleString(locales, options)

パラメータ

パラメータ 説明
locales オプション。使用する言語固有のフォーマット。以下のテーブルを参照してください。
options オプション。フォーマットオプションを持つオブジェクト。以下のテーブルを参照してください。

locales パラメータを受け入れる値：

  • ar-SA アラビア語（サウジアラビア）
  • bn-BD バングラデシュ語（バングラデシュ）
  • bn-IN バングラデシュ語（インド）
  • cs-CZ チェコ語（チェコ共和国）
  • da-DK デンマーク語（デンマーク）
  • de-AT オーストリアドイツ語
  • de-CH 「スイス」ドイツ語
  • de-DE 標準ドイツ語（ドイツで使用）
  • el-GR 現代ギリシャ語
  • en-AU オーストラリア英語
  • en-CA カナダ英語
  • en-GB イギリス英語
  • en-IE アイルランド英語
  • en-IN インド英語
  • en-NZ ニュージーランド英語
  • en-US アメリカ英語
  • en-ZA アフリカ南部英語
  • es-AR アルゼンチンスペイン語
  • es-CL チリスペイン語
  • es-CO コロンビアスペイン語
  • es-ES カスティーリャスペイン語（スペインの中北部で使用）
  • es-MX メキシコスペイン語
  • es-US アメリカスペイン語
  • fi-FI フィンランド語（フィンランド）
  • fr-BE ベルギーフランス語
  • fr-CA カナダフランス語
  • fr-CH 「スイス」フランス語
  • fr-FR 標準フランス語（特にフランスで使用）
  • he-IL ヘブライ語（イスラエル）
  • hi-IN ヒンディー語（インド）
  • hu-HU ハンガリー語（ハンガリー）
  • id-ID インドネシア語（インドネシア）
  • it-CH 「スイス」イタリア語
  • it-IT 標準イタリア語（イタリアで使用）
  • ja-JP 日本語（日本）
  • ko-KR 韓国語（大韓民国）
  • nl-BE ベルギー・オランダ語
  • nl-NL 標準オランダ語（オランダ語）
  • no-NO ノルウェー語（ノルウェー）
  • pl-PL ポーランド語（ポーランド）
  • pt-BR ブラジル・ポルトガル語
  • pt-PT ヨーロッパ・ポルトガル語（ポルトガル語の書き言葉と口語）
  • ro-RO ルーマニア語（ルーマニア）
  • ru-RU ロシア語（ロシア連邦）
  • sk-SK スロバキア語（スロバキア）
  • sv-SE スウェーデン語（スウェーデン）
  • ta-IN インド・タミル語
  • ta-LK スリランカ・タミル語
  • th-TH タイ語（タイ）
  • tr-TR トルコ語（トルコ）
  • zh-CN 中国大陆、簡体字
  • zh-HK 香港、繁体字
  • zh-TW 台湾、繁体字

options パラメータが受け入れるオプション：

オプション 値
currency 合法な値：どんな通貨コード（例えば "EUR", "USD", "INR" など）
currencyDisplay

合法な値：

  • "symbol"（デフォルト）
  • "code"
  • "name"
localeMatcher

合法な値：

  • "best-fit"（デフォルト）
  • "lookup"
maximumFractionDigits 0から20までの数字（デフォルトは3）
maximumSignificantDigits 1から21までの数字（デフォルトは21）
minimumFractionDigits 0から20までの数字（デフォルトは3）
minimumIntegerDigits 1から21までの数字（デフォルトは1）
minimumSignificantDigits 1から21までの数字（デフォルトは21）
style

合法な値：

  • "currency"
  • "decimal"（デフォルト）
  • "percent"
useGrouping

合法な値：

  • "true"（デフォルト）
  • "false"

返り値

タイプ 説明
文字列 ローカルのフォーマットで数字を表す文字列。

技術的詳細

返り値

数字の文字列表現は実装によって決定され、ローカルの規範に基づいてフォーマット化されます。小数点や千の単位の区切り記号に影響を与える可能性があります。

投げる

例外 説明
TypeError このメソッドを呼び出すオブジェクトが Number でない場合に投げられる例外。

ブラウザのサポート

toLocaleString() ECMAScript3 (ES3) の機能です。

すべてのブラウザが完全に ES3 (JavaScript 1999) をサポートしています：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート サポート サポート サポート サポート サポート