Zahl mit 2 Nachkommastellen ausgeben über PHP Funktion number_format()

Oft möchte man eine Zahl mit 2 Nachkommazahlen in der korrekten deutschen Schreibweise mit einem Komma anstelle des standardmäßigen Punktes ausgeben. Zusätzlich ist in der Ausgabe noch das 1000er-Trennzeichen schön, da dieses große Zahlen gut lesbar macht.

Alles kein Problem, da es in PHP mit der number_format() Funktion eine integrierte Möglichkeit gibt.

Hier können wir die Anzahl der Nachkommastellen definieren und das verwendete Trennzeichen für die Nachkommastelle und auch das Trennzeichen für die Tausender.

Hier direkt als Beispiel, wie wir eine Zahl in der gewohnten deutschen Schreibweise ausgeben können:

<?php
$zahl = 5531.99;
echo number_format($zahl, 2, '.', ',');

// Ergebnis ist als Ausgabe 5.531,99
?>

Aufbau Funktion number_format()

Wie ist der Aufbau der Funktion? Was kann mitgegeben werden und was muss mitgegeben werden?

Minimaler Aufbau:

number_format(
	Zahl,
	Anzahl Dezimalstellen
)

In der Nutzung sieht es dann im minimalen Aufbau wie folgt aus:

$zahl = 5531.992;
echo number_format($zahl, 2);

// Ergebnis ist als Ausgabe 5531.99

Was ist der Vorteil? Es wird gerundet, ab .5 – ändern wir unsere Beispielzahl für die Demonstration:

$zahl = 5531.995;
echo number_format($zahl, 2);

// Ergebnis ist als Ausgabe 5532.00

Ab PHP 8 können 1 Parameter (also die Zahl), 2 Parameter (also Zahl und Anzahl Nachkommastellen) oder müssen alle 4 Parameter (zusätzlich Trennzeichen für die Nachkommastelle und auch das Trennzeichen für die Tausender) angegeben werden. Drei Parameter ergeben ein Problem.

Trennzeichen für Nachkommazahl und Tausender setzen

Wie schon im vorherigen Beispiel mit allen 4 Parametern:

$zahl = 5531.99;
echo number_format($zahl, 2, '.', ',');

// Ergebnis ist als Ausgabe 5.531,99

Vorteil der Funktion ist, dass wir auch schnell die französische Notation erreichen können, die die Tausenderstelle mit einem Leerzeichen abtrennt:

$zahl = 5531.99;
echo number_format($zahl, 2, ' ', ',');

// französische Ausgabe
// Ergebnis ist als Ausgabe 5 531,99

WICHTIG bei der Funktion number_format()

Als Rückgabewert erhalten wir einen String. Das bedeutet, dass wir damit nicht weiterrechnen können. Daher die Funktion number_format() immer nach allen gewünschten Berechnungen für die Ausgabe einsetzen.