number_format

(PHP 4, PHP 5, PHP 7, PHP 8)

number_format — Formatta un numero con i gruppi delle migliaia

Descrizione

number_format(
    float $number,
    int $decimals = ?,
    string $dec_point = ?,
    string $thousands_sep
): string

La funzione number_format() restituisce una versione formattata di number. Questa funzione accetta uno, due, o quattro parametri (non tre).

Se si specifica soltanto un parametro, il number sarà formattato senza decimali, ma con la virgola (",") per suddividere le migliaia.

Se sono specdificati due parametri, il number sarà formattato con tante cifre decimali quanto indicato in decimals, precedute dal punto ("."), e con la virgola (",") come separatore delle migliaia.

Se sono indicati tutti i quattro parametri, il number sarà formattato con decimals cifre decimali, identificate dal carattere dec_point anziché dal punto (".") e con thousands_sep, invece della virgola (",") come separatore delle migliaia.

Sarà utilizzato solo il primo carattere di thousands_sep. Ad esempio, se si indica foo come thousands_sep per il numero 1000, la funzione number_format() restituirà 1f000.

Example #1 Esempio di uso di number_format()

Ad esempio, la notazione francese solitamente utilizza due decimali, la virgola (',') come separatore decimale, e lo spazio (' ') come separatore delle migliaia. Questo può essere ottenuto con:

<?php

$number = 1234.56;

// Notazione inglese (default)
$english_format_number = number_format($number);
// 1,235

// Notazione francese
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56

$number = 1234.5678;

// notazione inglese senza separatore delle migliaia
$english_format_number = number_format($number, 2, '.', '');
// 1234.57

?>

Vedere anche sprintf(), printf() e sscanf().