JavaScript Number.toLocaleString()メソッド
例
ローカル設定を使用して文字列をフォーマットする:
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 | オプション。次のように指定できます:
|
戻り値
| 型 | 説明 |
|---|---|
| 文字列 | ロケールにおける表現文字列を返します。 |
技術詳細
| 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"});
試してみる »