PHP number_format(): Binlik Ayırıcı ve Ondalıklar

number_format($number, $decimals) sayıyı bir binlik ayırıcı ve sabit sayıda ondalıkla bir dizge olarak döndürür: number_format(1234567.891, 2) "1,234,567.89" döndürür. Tek argümanla tam sayıya yuvarlar: number_format(1234567.891) "1,234,568" olur.

<?php
$amount = 1234567.891;

echo number_format($amount), "\n";            // no decimals
echo number_format($amount, 2), "\n";         // 2 decimals
echo number_format($amount, 2, ',', '.'), "\n"; // European style
echo number_format(0.129, 2), "\n";
echo number_format(-1234.567, 1), "\n";

Dört parametre

number_format(
    float $num,
    int $decimals = 0,
    ?string $decimal_separator = ".",
    ?string $thousands_separator = ","
): string

Üçüncü argüman tam kısım ile ondalıklar arasındaki karakter, dördüncüsü üçlü basamak grupları arasındaki karakterdir. İkisi de boş bir dizge veya çok baytlı bir karakter dahil herhangi bir dizge olabilir. Her stili görmek için aşağıdaki ayırıcıları düzenleyin:

<?php
$n = 1234567.891;

echo number_format($n, 2, '.', ','), "  US, UK, Japan\n";
echo number_format($n, 2, ',', '.'), "  Germany, Spain, Italy, Brazil\n";
echo number_format($n, 2, ',', ' '), "  France, Russia, Poland\n";
echo number_format($n, 2, '.', "'"), "  Switzerland\n";
echo number_format($n, 2, '.', ''), "  no separator\n";

Yerel ayar verileri (CLDR) Fransızca için dar bölünemez boşluk (U+202F), Rusça için bölünemez boşluk (U+00A0) kullanır, böylece bir sayı asla iki satıra bölünmez. HTML'de ayırıcı olarak düz bir boşluk yerine "\u{202F}" veya "\u{00A0}" verin.

Bir sayıyı binlik ayırıcı olmadan biçimlendirme

Dördüncü argüman olarak '' verin. Sabit sayıda ondalıklı düz bir sayı elde edersiniz; ödeme ağ geçitlerinin, CSV dışa aktarımlarının ve <input type="number"> değerlerinin beklediği biçim budur:

<?php
$prices = [5, 19.9, 1234.5];

foreach ($prices as $p) {
    echo number_format($p, 2, '.', ''), "\n";
}

// Cents as an integer, for APIs that want the smallest unit
echo (int) round(19.9 * 100), "\n";

Son satır için dönüştürmeden önceki round() önemlidir: 19.9 * 100 1989.9999999999998 olarak saklanır ve tek başına (int) onu 1989 değerine keserdi.

number_format nasıl yuvarlar

number_format() round() gibi yarımı sıfırdan uzağa doğru yuvarlar, bu yüzden 0.5 1, -2.5 ise -3 olur. Ayrıca 2.675 gibi değerlerdeki küçük ikili hatayı düzeltir; sprintf('%.2f') ile farklı sonuç verebilmesinin nedeni budur:

<?php
foreach ([0.5, 1.5, 2.5, -2.5] as $x) {
    echo $x, " => ", number_format($x), "\n";
}

echo "\n";
echo number_format(2.675, 2), "  number_format\n";
echo sprintf('%.2f', 2.675), "  sprintf\n";
echo round(2.675, 2), "  round\n";

// PHP 8.3: negative decimals round to tens, hundreds, thousands
echo number_format(1234567, -3), "\n";

2.675 ikili sistemde tam olarak saklanamaz; saklanan değer ondan çok az küçüktür. sprintf() saklanan bu değeri biçimlendirir ve 2.67 bulur, number_format() ve round() ise onu yazdığınız 2.675 olarak ele alır. Belirli bir yuvarlama kuralına ihtiyacınız varsa önce round(), floor() veya ceil() fonksiyonunu kendiniz çağırın (yuvarlama ve matematik sayfasına bakın) ve sonucu number_format() fonksiyonuna verin.

Para ve diğer para birimlerini biçimlendirme

number_format() para birimleri hakkında hiçbir şey bilmez, bu yüzden simgeyi kendiniz eklersiniz. Eksi işaretlerini simgeden önce koyun ve yenin ondalığı olmadığını unutmayın:

<?php
function money(float $amount, string $symbol = '$'): string
{
    $sign = $amount < 0 ? '-' : '';
    return $sign . $symbol . number_format(abs($amount), 2);
}

echo money(1499.5), "\n";
echo money(-20), "\n";
echo money(1234.5, '€'), "\n";

// Japanese yen: no decimals, 円 after the number
echo number_format(1980), "円\n";
echo '¥' . number_format(128000), "\n";

Her ülke için doğru simge konumuyla yerel ayara duyarlı çıktı için intl eklentisinin NumberFormatter sınıfı işin tamamını yapar:

$fmt = new NumberFormatter('de_DE', NumberFormatter::CURRENCY);
echo $fmt->formatCurrency(1234.5, 'EUR'); // 1.234,50 € (a no-break space before €)

Her yerde kurulu olmayan intl eklentisini gerektirir, bu yüzden kendi simgenizle number_format() taşınabilir seçimdir.

Sonuç bir sayı değil, bir dizgedir

number_format() ile en yaygın hata budur: bir değeri biçimlendirip ardından onunla hesap yapmak. "1,234.50" sayısal bir dizge değildir, bu yüzden PHP yalnızca virgülden önceki 1 değerini okur:

<?php
echo number_format(1234.5, 2) + 1;

Warning: A non-numeric value encountered in /home/index.php on line 2
2

Böyle bir dizgeyi number_format() fonksiyonuna geri vermek daha kötüdür: TypeError: number_format(): Argument #1 ($num) must be of type int|float, string given fırlatır. Matematik için ham sayıyı tutun ve yalnızca yazdırdığınız anda biçimlendirin. Bir formdan veya dosyadan biçimlendirilmiş bir dizge alırsanız önce ayırıcıları temizleyin:

<?php
$total = 1234.5;
$display = number_format($total, 2);      // for output only

echo $display, "\n";
echo number_format($total + 100, 2), "\n"; // math on the number, then format

// Turning "1,234.50" back into a float
$input = '1,234.50';
$value = (float) str_replace(',', '', $input);
var_dump($value);

// European input "1.234,50"
$eu = '1.234,50';
$value = (float) str_replace(['.', ','], ['', '.'], $eu);
var_dump($value);

Sayının önünde doldurma, hizalama veya artı işareti için bunun yerine sprintf() kullanın; binlik ayırıcı eklemez ama genişliği ve işareti kontrol eder.