JavaScript Number toLocaleString() Metodu

Tanım ve Kullanım

toLocaleString() Yerel dil biçimini kullanarak sayıyı string olarak döndürme.

Dil biçimi, bilgisayarınızdaki bölge ayarlarına bağlıdır.

Örnek

Örnek 1

Bölge ayarlarını kullanarak sayıyı string'e dönüştürme:

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

Kişisel olarak deneyin

Örnek 2

Finlandiya'nın belirli dil ortamını kullanarak sayıyı string'e dönüştürme:

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

Kişisel olarak deneyin

Örnek 3

ABD'nin belirli dil ortamını kullanarak sayıyı para string'ine dönüştürme:

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

Kişisel olarak deneyin

Örnek 4

Kullanarak options Para formatlamasında parametre (nesne) kullanma:

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

Kişisel olarak deneyin

Örnek 5

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

Kişisel olarak deneyin

Örnek 6

JAPAN'ın özel dil ortamını kullanma:

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

Kişisel olarak deneyin

Dilbilgisi

number.toLocaleString(locales, options)

Parametre

Parametre Açıklama
locales Opsiyonel. Kullanılacak dil spesifik formatı. Aşağıdaki tabloya bakın.
options Opsiyonel. Format seçenekleri olan bir nesne. Aşağıdaki tabloya bakın.

locales Parametre olarak kabul edilebilir değerler:

  • ar-SA Arapça (Suudi Arabistan)
  • bn-BD Bengalce (Bangladeş)
  • bn-IN Bengalce (Hindistan)
  • cs-CZ Çekçe (Çek Cumhuriyeti)
  • da-DK Danimarkaca (Danimarka)
  • de-AT Avusturya Almanca
  • de-CH “İsviçre” Almanca
  • de-DE Standart Almanca (Almanya'da kullanılır)
  • el-GR Modern Yunanca
  • en-AU Avustralya İngilizcesi
  • en-CA Kanada İngilizcesi
  • en-GB İngilizce (İngiltere)
  • en-IE İrlanda İngilizcesi
  • en-IN Hindistan İngilizcesi
  • en-NZ Yeni Zelanda İngilizcesi
  • en-US Amerika İngilizcesi
  • en-ZA Güney Afrika İngilizcesi
  • es-AR Arjantin İspanyolcası
  • es-CL Şili İspanyolcası
  • es-CO Kolombiya İspanyolcası
  • es-ES Kastilya İspanyolcası (İspanya'nın kuzeydoğusunda kullanılır)
  • es-MX Meksika İspanyolcası
  • es-US Amerika İspanyolcası
  • fi-FI Fince (Finlandiya)
  • fr-BE Belçika Fransızca
  • fr-CA Kanada Fransızca
  • fr-CH “İsviçre” Fransızca
  • fr-FR Standart Fransızca (özellikle Fransa'da)
  • he-IL İbranice (İsrail)
  • hi-IN Hindice (Hindistan)
  • hu-HU Macarca dili (Macaristan)
  • id-ID Endonezyaca (Endonezya)
  • it-CH “İsviçre” İtalyanca
  • it-IT Standart İtalyanca (İtalya'da kullanılır)
  • ja-JP Japonca (Japonya)
  • ko-KR Korece (Kore Cumhuriyeti)
  • nl-BE Belçika Hollanda
  • nl-NL Standart Hollanda (Hollanda)
  • no-NO Norveççe (Norveç)
  • pl-PL Lehçe (Polonya)
  • pt-BR Brezilya Portekizcesi
  • pt-PT Avrupa Portekizcesi (Portekizce yazı ve konuşma)
  • ro-RO Romence (Romanya)
  • ru-RU Rusça (Rusya Federasyonu)
  • sk-SK Slovakça (Slovakya)
  • sv-SE İsveççe (İsveç)
  • ta-IN Hindistan Tamil dili
  • ta-LK Sri Lanka Tamil dili
  • th-TH Tay (泰国)
  • tr-TR Türkçe (Türkiye)
  • zh-CN Çin Halk Cumhuriyeti, basit karakter
  • zh-HK Hong Kong, karmaşık karakter
  • zh-TW Tayvan, karmaşık karakter

options Parametre tarafından kabul edilen seçenekler:

Seçenekler Değer
currency Geçerli değerler: Herhangi bir para kodu (örneğin, "EUR", "USD", "INR" vb.)
currencyDisplay

Geçerli değerler:

  • "symbol"(Varsayılan)
  • "code"
  • "name"
localeMatcher

Geçerli değerler:

  • "best-fit"(Varsayılan)
  • "lookup"
maximumFractionDigits 0'dan 20'ye kadar olan sayılar (varsayılan 3)
maximumSignificantDigits 1'den 21'e kadar olan sayılar (varsayılan 21)
minimumFractionDigits 0'dan 20'ye kadar olan sayılar (varsayılan 3)
minimumIntegerDigits 1'den 21'e kadar olan sayılar (varsayılan 1)
minimumSignificantDigits 1'den 21'e kadar olan sayılar (varsayılan 21)
style

Geçerli değerler:

  • "currency"
  • "decimal"(Varsayılan)
  • "percent"
useGrouping

Geçerli değerler:

  • "true"(Varsayılan)
  • "false"

Dönüş değeri

Tür Açıklama
String Yerel biçimde sayıyı temsil eden string.

Teknik ayrıntılar

Dönüş değeri

Sayının string ifadesi, uygulama tarafından belirlenir, yerel normlara göre biçimlendirilir ve küsürat noktası veya binlik ayraç simgesi kullandığı noktalama işaretlerini etkileyebilir.

Atanır

İstisna Açıklama
TypeError Bu yöntemi çağıran nesne Number değilse atılan istisna.

Tarayıcı desteği

toLocaleString() ECMAScript3 (ES3) özelliklerindendir.

Tüm tarayıcılar ES3 (JavaScript 1999) tamamen destekler:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Destek Destek Destek Destek Destek Destek