number_format
(PHP 4, PHP 5, PHP 7, PHP 8)
number_format — Formatiert eine Zahl mit Tausender-Trennzeichen
Beschreibung
float
$num,int
$decimals = 0,?string
$decimal_separator = ".",?string
$thousands_separator = ","): string
Formatiert eine Zahl mit Tausender-Trennzeichen und optionalen Dezimalziffern.
Parameter-Liste
-
num -
Die zu formatierende Zahl.
-
decimals -
Bestimmt die Anzahl an Nachkommastellen.
-
decimal_separator -
Bestimmt das Trennzeichen für die Nachkommastellen.
-
thousands_separator -
Bestimmt das Tausendertrennzeichen.
Rückgabewerte
Eine formatierte Version von num.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 | Vor dieser Version akzeptierte number_format() einen, zwei oder vier Parameter (aber nicht drei). |
| 7.2.0 |
number_format() wurde geändert, so dass es nicht
mehr -0 zurückgeben kann; zuvor konnte
-0 zurückgegeben werden, z.B. wenn
num gleich -0.01 war.
|
Beispiele
Beispiel #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 folgende Beispiel zeigt verschiedene Varianten eine Zahl zu formatieren:
<?php
$number = 1234.56;
// Englische Notation (Standard)
$english_format_number = number_format($number);
// 1,235
// Französische 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() - Formatiert eine Zahl als Währungs-Zeichenkette
- sprintf() - Gibt einen formatierten String zurück
- printf() - Liefert einen formatierten String
- sscanf() - Überträgt einen String in ein angegebenes Format
