number_format
(PHP 4, PHP 5)
number_format — Formatiert eine Zahl mit Tausender-Gruppierung
Beschreibung
number_format() gibt eine formatierte Version von number zurück. Die Funktion akzeptiert entweder einen, zwei oder vier Parameter (nicht jedoch drei):
Wird nur ein Parameter übergeben, wird number ohne Dezimalstellen, aber mit einem Komma (",") zur Gruppierung der Tausenderstellen formatiert.
Wurden zwei Parameter übergeben, wird number als Zahl mit decimals Dezimalstellen mit einem Punkt (".") als Trennzeichen sowie einem Komma (",") zur Gruppierung der Tausenderstellen formatiert.
Wenn alle vier Parameter übergeben wurden, wird number als Zahl formatiert, die decimals Dezimalstellen hat, die mittels dec_point anstelle des Punktes (".") von der Zahl getrennt werden, und deren Tausenderstellen mittels thousands_sep anstelle des Kommas (",") gruppiert werden.
Nur das erste Zeichen von thousands_sep wird verwendet. Wenn Sie beispielsweise bar für thousands_sep auf die Zahl 1000 anwenden, gibt Ihnen number_format() 1b000 zurück.
Example#1 number_format()-Beispiel
Beispielsweise notiert man in Frankreich normalerweise zwei Dezimalstellen mit einem Komma (',') als Trennzeichen sowie ein Leerzeichen (' ') zur Gruppierung der Tausender. Das kann durch folgende Zeile erreicht werden:
<?php
$number = 1234.56;
// Englische Notation (Standard)
$english_format_number = number_format($number);
// 1,235
// Franzoesische Notation
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// Englische Notation ohne Tausendergruppierung
$english_format_number = number_format($number, 2, '.', '');
// 1234.57
?>
Siehe auch money_format(), sprintf(), printf() und sscanf().