number_format() PHP: Pemisah Ribuan dan Desimal

number_format($number, $decimals) mengembalikan angka sebagai string dengan pemisah ribuan dan jumlah desimal yang tetap: number_format(1234567.891, 2) mengembalikan "1,234,567.89". Dengan satu argumen, fungsi ini membulatkan ke bilangan bulat: number_format(1234567.891) menghasilkan "1,234,568".

<?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";

Keempat parameternya

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

Argumen ketiga adalah karakter di antara bagian bulat dan desimal, argumen keempat adalah karakter di antara kelompok tiga digit. Keduanya bisa berupa string apa pun, termasuk string kosong atau karakter multibyte. Ubah pemisah di bawah ini untuk melihat setiap gaya:

<?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";

Data locale (CLDR) memakai narrow no-break space (U+202F) untuk bahasa Prancis dan no-break space (U+00A0) untuk bahasa Rusia, sehingga sebuah angka tidak pernah terpotong ke dua baris. Di HTML, berikan "\u{202F}" atau "\u{00A0}" sebagai pemisah alih-alih spasi biasa.

Memformat angka tanpa pemisah ribuan

Berikan '' sebagai argumen keempat. Kamu mendapat angka biasa dengan jumlah desimal yang tetap, bentuk yang diharapkan oleh payment gateway, ekspor CSV, dan nilai <input type="number">:

<?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";

Untuk baris terakhir, round() sebelum cast itu penting: 19.9 * 100 disimpan sebagai 1989.9999999999998, dan (int) saja akan memotongnya menjadi 1989.

Cara number_format membulatkan

number_format() membulatkan setengah menjauhi nol, seperti round(), jadi 0.5 menjadi 1 dan -2.5 menjadi -3. Fungsi ini juga mengoreksi kesalahan biner yang sangat kecil pada nilai seperti 2.675, itulah sebabnya hasilnya bisa berbeda dengan sprintf('%.2f'):

<?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 tidak bisa disimpan dengan tepat dalam biner; nilai yang tersimpan sedikit di bawahnya. sprintf() memformat nilai yang tersimpan itu dan mendapat 2.67, sedangkan number_format() dan round() memperlakukannya sebagai 2.675 yang kamu tulis. Jika kamu butuh aturan pembulatan tertentu, panggil round(), floor(), atau ceil() sendiri lebih dulu (lihat pembulatan dan matematika) lalu berikan hasilnya ke number_format().

Memformat uang dan mata uang lain

number_format() tidak tahu apa pun tentang mata uang, jadi kamu menambahkan simbolnya sendiri. Taruh tanda negatif sebelum simbol, dan ingat bahwa yen tidak punya desimal:

<?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";

Untuk output yang mengikuti locale dengan posisi simbol yang tepat untuk setiap negara, NumberFormatter dari extension intl mengerjakan semuanya:

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

Fungsi ini membutuhkan extension intl, yang tidak terpasang di semua tempat, jadi number_format() dengan simbolmu sendiri adalah pilihan yang paling portabel.

Hasilnya string, bukan angka

Inilah bug paling umum dengan number_format(): memformat sebuah nilai lalu melakukan perhitungan dengannya. "1,234.50" bukan string numerik, jadi PHP hanya membaca 1 sebelum koma:

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

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

Memberikan string seperti itu kembali ke number_format() lebih buruk lagi: hasilnya TypeError: number_format(): Argument #1 ($num) must be of type int|float, string given. Simpan angka mentahnya untuk perhitungan dan format hanya pada saat kamu mencetak. Jika kamu menerima string yang sudah diformat dari form atau file, hapus pemisahnya lebih dulu:

<?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);

Untuk padding, perataan, atau tanda plus di depan angka, pakai sprintf(); fungsi itu tidak menambahkan pemisah ribuan, tetapi mengatur lebar dan tanda.