JavaScript Number toLocaleString() -menetelmä

Määritelmä ja käyttö

toLocaleString() Palauta luku merkkijonona paikallisen kieliasetuksen mukaisesti.

Kieliasetus riippuu tietokoneesi alueasetuksista.

Esimerkki

Esimerkki 1

Käytä alueasetuksia muuntaaksesi luvun merkkijonoksi:

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

Kokeile itse

Esimerkki 2

Käytä Suomen erityistä kieliympäristöä muuntaaksesi luvun merkkijonoksi:

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

Kokeile itse

Esimerkki 3

Käytä Yhdysvaltojen erityistä kieliympäristöä muuntaaksesi luvun valuuttamuotoon merkkijonoksi:

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

Kokeile itse

Esimerkki 4

Käytä options Muotoile valuuttaa parametrina (objekti):

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

Kokeile itse

Esimerkki 5

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

Kokeile itse

Esimerkki 6

Käytä JAPAN:n erityistä kielimiljöä:

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

Kokeile itse

Grammar

number.toLocaleString(locales, options)

Muuttuja

Muuttuja Kuvaus
locales Valinnainen. Käytettävä kielimääritys. Katso taulukko alla.
options Valinnainen. Objekti, joka sisältää muotoiluvalitsimet. Katso taulukko alla.

locales Muuttujien sallitut arvot:

  • ar-FI Arabia (Saudi-Arabia)
  • bn-FI Bengali (Bangladesh)
  • bn-FI Bengali (Intia)
  • cs-FI Tšekin kieli (Tšekin tasavalta)
  • da-FI Tanskan kieli (Tanska)
  • de-FI Itävallan saksa
  • de-FI Sveitsin saksa
  • de-FI Standardisaksa (Saksassa käytössä)
  • el-FI Nykyinen kreikka
  • en-FI Australian englanti
  • en-FI Kanadan englanti
  • en-FI Brittiläinen englanti
  • en-FI Irlannin englanti
  • en-FI Intian englanti
  • en-FI Uuden-Seelannin englanti
  • en-FI Yhdysvaltain englanti
  • en-FI Englanti (Etelä-Afrikka)
  • es-FI Argentiinan espanja
  • es-FI Chilen espanja
  • es-FI Kolumbia espanja
  • es-FI Kastilia espanja (Keski- ja pohjois-Spanjassa käytössä)
  • es-FI Meksikon espanja
  • es-FI Yhdysvaltain espanja
  • fi-FI Suomen kieli (Suomi)
  • fr-FI Belgian ranska
  • fr-FI Kanadan ranska
  • fr-FI Sveitsin ranska
  • fr-FI Standardifranca (erityisesti Ranskassa)
  • he-FI Heprea (Israel)
  • hi-FI Hindi (Intia)
  • hu-FI Unghuria kieli (Unghuria)
  • id-ID Indonesia (Indonesia)
  • it-CH “Sveitsin” italialainen
  • it-IT Standardi italialainen (Käytetään Italiassa)
  • ja-JP Japani (Japani)
  • ko-KR Korea (Dongniana)
  • nl-BE Belgian hollanti
  • nl-NL Standardi hollanti (hollanti)
  • no-NO Norja (Norja)
  • pl-PL Puola (Puola)
  • pt-BR Brasilian portugali
  • pt-PT Eurooppalainen portugali (kirjallinen ja suullinen portugali)
  • ro-RO Romania (Romania)
  • ru-RU Venäjä (Venäjän federaatio)
  • sk-SK Slovak (Slovakia)
  • sv-SE Ruotsi (Ruotsi)
  • ta-IN Intian tamil
  • ta-LK Sri Lankan tamil
  • th-TH Thai (Thaimaa)
  • tr-TR Turkki (Turkki)
  • zh-CN Kiina, yksinkertainen kiinan kieli
  • zh-HK Hongkong, kiinan kieli (perinteinen)
  • zh-TW Taiwan, kiinan kieli (perinteinen)

options Parametrin hyväksymät valinnat:

valinnat arvo
currency Sallitut arvot: mikä tahansa valuuttakoodi (esim. "EUR", "USD", "INR" jne.)
currencyDisplay

Sallitut arvot:

  • "symbol"(Oletus)
  • "code"
  • "name"
localeMatcher

Sallitut arvot:

  • "best-fit"(Oletus)
  • "lookup"
maximumFractionDigits Luku 0-20 (oletus on 3)
maximumSignificantDigits Luku 1-21 (oletus on 21)
minimumFractionDigits Luku 0-20 (oletus on 3)
minimumIntegerDigits Luku 1-21 (oletus on 1)
minimumSignificantDigits Luku 1-21 (oletus on 21)
style

Sallitut arvot:

  • "currency"
  • "decimal"(Oletus)
  • "percent"
useGrouping

Sallitut arvot:

  • "true"(Oletus)
  • "false"

Palautusarvo

Tyyppi Kuvaus
Merkkijono Paikallisen muodon lukuja esittävän merkkijonon.

Tekninen yksityiskohta

Palautusarvo

Luvun merkkijono-esitys, jota toteutus päättää, muotoillaan paikallisten sääntöjen mukaan, mikä voi vaikuttaa desimaalipisteeseen tai tuhannesosien erottimeen käytettävään merkkijonoon.

Heitetään

Poikkeus Kuvaus
TypeError Poikkeus heitetään, jos kutsuttu objekti ei ole Number.

Selaimeen tuettu

toLocaleString() On ECMAScript3 (ES3) ominaisuus.

Kaikki selaimet tukevat täysin ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Tuki Tuki Tuki Tuki Tuki Tuki