JavaScript Number.toLocaleString()メソッド

JavaScript Number オブジェクト

例

ローカル設定を使用して文字列をフォーマットする:

let num1 = 1000000; let text1 = num1.toLocaleString(); //特定のロケールを使用して数値を文字列にフォーマットする let num2 = 1000000; let text2 = num2.toLocaleString("fi-FI"); //特定のロケールを使用して数値を通貨文字列にフォーマットする //人民元 let num3 = 1000000; let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"}); //米ドル let num4 = 1000000; let text4 = num4.toLocaleString("en-US", {style:"currency", currency:"USD"});

試してみる »

定義と用法

toLocaleString() メソッドは、特定のロケールにおける数値の表現文字列を返します。

新しい locales および options パラメータにより、アプリケーションはフォーマット変換を行う言語を指定し、関数の動作をカスタマイズできます。古い実装では、locales と options パラメータは無視され、使用されるロケールと返される文字列の形式は実装に完全に依存します。


ブラウザサポート

Number.toLocaleString() は ECMAScript3 (ES3) の機能です。

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

Chrome IE Edge Firefox Safari Opera
Yes Yes Yes Yes Yes Yes

最新バージョンのブラウザはすべてサポートしています(locales, options)パラメータ:

Chrome IE Edge Firefox Safari Opera
Yes 11 Yes Yes Yes Yes

構文

number.toLocaleString(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 オプション。次のように指定できます:
  • "decimal"純粋な数値フォーマットに使用;
  • "currency"通貨フォーマットに使用;
  • "percent"パーセントフォーマットに使用;
  • "unit"単位フォーマットに使用

戻り値

型 説明
文字列 ロケールにおける表現文字列を返します。

技術詳細

JavaScript バージョン: ECMAScript 6

その他の例

例

オプションパラメータを使用して、通貨文字列をフォーマットします:

let num1 = new Number(1000000); const myObj = { style: "currency", currency: "EUR" } let text1 = num1.toLocaleString("en-GB", myObj); let num2 = new Number(1000000); let text2 = num2.toLocaleString("en-GB", {style:"currency", currency:"EUR"}); //人民元 let num3 = 1000000; let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"}); //円 let num4 = 1000000; let text4 = num4.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

試してみる »

JavaScript Number オブジェクト

その他の拡張