Tutorial

JavaScript Intl.NumberFormat: Sayı, Para ve Yüzde Gösterimi

Mehmet Fatih Ünal
16 Kasım 2026
7 dk okuma
#JavaScript#Intl#NumberFormat#i18n#formatToParts
JavaScript Intl.NumberFormat: Sayı, Para ve Yüzde Gösterimi

Aynı sayıyı iki dilde nasıl gösterirsiniz?

Bir rapordaki 12345.6 sayısı, Türkçe arayüzde 12.345,6; İngilizce ABD biçiminde 12,345.6 olarak gösterilebilir. Bu farkı nokta ve virgülü zincirleme değiştiren bir yardımcıyla çözmek, para simgeleri ve boşluklar devreye girdiğinde zorlaşır. Intl.NumberFormat gösterimi locale ve seçeneklere göre üretir.

Saklanan değer ile ekranda görünen metni ayrı tutun. Bu yazı tutar hesaplama ya da kur dönüşümü yapmıyor. Amaç, zaten elinizde olan değerin kullanıcıya nasıl sunulacağını belirlemek. MDN NumberFormat referansı temel API'yi açıklar.

Locale'i açıkça seçin

const amount = 12345.6;
const tr = new Intl.NumberFormat('tr-TR', {
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
});
const en = new Intl.NumberFormat('en-US', {
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
});
console.log(tr.format(amount)); // 12.345,60
console.log(en.format(amount)); // 12,345.60
console.log(amount); // 12345.6

Dil kodunu vermemek, çalıştığı ortamın varsayılanına bağlı sonuç üretir. Sunucu ve tarayıcı farklı varsayılanlarla çalışıyorsa aynı kayıt farklı görünebilir. Liste için aynı ayarları kullanan biçimlendiriciyi bir kez oluşturup tekrar kullanabilirsiniz. Tarihlerde benzer ayrımı Intl.DateTimeFormat yazısında ele aldık.

Para birimi seçimi döviz dönüşümü değildir

const money = new Intl.NumberFormat('tr-TR', {
  style: 'currency',
  currency: 'TRY',
  currencyDisplay: 'code',
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
});
const parts = money.formatToParts(1234.5);
console.log(parts.find(part => part.type === 'currency').value); // TRY
console.log(parts.find(part => part.type === 'fraction').value); // 50
console.log(parts.map(part => part.value).join('') === money.format(1234.5)); // true

TRY yerine USD yazmak tutarı dolar karşılığına çevirmez; yalnızca para birimi gösterimini değiştirir. Bu örnekte basamak sayısını ikiye sabitledik. Bütün para birimlerinin varsayılanı iki basamak değildir; ürününüzün desteklediği para birimleri için sözleşmeyi açıkça belirleyin.

Çıktıdaki para kodu ile sayı arasında normal boşluktan farklı bir Unicode boşluğu bulunabilir. Simgenin daima başta olduğunu veya karakter konumunun sabit kaldığını varsaymayın. formatToParts belgesi sayı, grup, kesir ve para birimi parçalarını tanımlar. Özel bir görünüm kurarken parça sırasını ve literal boşlukları koruyun.

Yüzde biçimine oran verin

const percent = new Intl.NumberFormat('en-US', {
  style: 'percent',
  minimumFractionDigits: 1,
  maximumFractionDigits: 1,
});
console.log(percent.format(0.125)); // 12.5%
console.log(percent.format(12.5)); // 1,250.0%

Veriniz 12.5 yüzde puanı olarak tutuluyorsa önce 100'e bölün. Zaten 0.125 oranıysa yeniden bölmeyin. Alanın adını ve birimini belirlemek, ekrandaki yüzde işaretinden daha faydalıdır. İlerleme çubuğu için 0–100 aralığı kullanan progress/meter örneği farklı bir arayüz sözleşmesine sahiptir.

Gösterim yuvarlaması hesaplama modelini düzeltmez

const value = 1.236;
const display = new Intl.NumberFormat('en-US', {
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
});
console.log(display.format(value)); // 1.24
console.log(value); // 1.236
console.log(0.1 + 0.2 === 0.3); // false
console.log(display.format(0.1 + 0.2)); // 0.30

Ekranda 0.30 görmek, alttaki kayan nokta hesabının tam ondalık aritmetik yaptığı anlamına gelmez. Parasal iş kuralları için uygun bir hesaplama modeli ve açık yuvarlama politikası gerekir. Küçük tam sayı birimleri kullanıyorsanız güvenli tam sayı sınırını da denetleyin; güvenli toplama örneği bu sınırı inceler.

minimumFractionDigits ile maximumFractionDigits farklı işler yapar. İkisini iki seçmek iki basamak gösterir. Yalnızca maksimumu iki yapmak 1 sayısını 1.00 olarak gösterme zorunluluğu koymaz. Seçenekler belgesi varsayılanları ayrıntılandırır.

Biçimlendirilmiş metni veri olarak geri kullanmayın

const integer = new Intl.NumberFormat('en-US', { maximumFractionDigits: 0 });
function formatCount(value) {
  if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
    return '-';
  }
  return integer.format(value);
}
console.log(formatCount(1234)); // 1,234
console.log(formatCount(NaN)); // -
console.log(formatCount('1234')); // -
console.log(Number('1.234,50')); // NaN

Bu yardımcı bir gösterim sınırı koyuyor; negatif, kesirli veya güvenli aralık dışındaki değer için çizgi gösteriyor ve metni sessizce sayıya çevirmiyor. Bir giriş ayrıştırıcısı değildir. NumberFormat da yerelleştirilmiş kullanıcı girdisini tersine çözen bir parse metodu sunmaz. Arama, sıralama ve API yükünde ham sayıyı koruyun; yalnızca görüntüleneceği noktada metne dönüştürün.

Sık sorulan sorular

format sayıyı değiştirir mi? Hayır, bir gösterim metni döndürür. Örneklerdeki amount ve value değişkenleri aynı kalır.

Para simgesini metinden kesebilir miyim? Sabit konum yerine formatToParts kullanın; parçaların sırası ve boşlukları locale'e göre değişebilir.

Sunucu ve tarayıcıda bütün çıktılar harfiyen aynı mı? Locale verisi ve çalışma ortamı etkileyebilir. Kritik gösterimleri desteklediğiniz ortamlarda test edin; boşlukları basit ASCII varsayımıyla karşılaştırmayın.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar