Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

number_format

String-Funktionen

    Befehl:
string number_format ( float $number [, int $decimals = 0 ] )

string number_format ( float $number , int $decimals = 0 , string $dec_point = '.' , string $thousands_sep = ',' )


    Parameter-Liste:
NameBeschreibung
numberDie zu formatierende Zahl.
decimalsLegt die Anzahl der Dezimalstellen.
dec_pointBestimmt das Trennzeichen für die Nachkommastellen.
thousand_sepBestimmt das Tausendertrennzeichen.

    Rückgabewerte:
Eine formatierte Version von number.

    Beschreibung:
Die Funktion akzeptiert entweder einen, zwei oder vier Parameter (nicht jedoch drei):

Wird nur ein Parameter übergeben, wird number ohne Nachkommastellen, aber mit einem Komma (",") zur Gruppierung der Tausenderstellen formatiert.

Wurden zwei Parameter übergeben, wird number als Zahl mit decimals Nachkommastellen 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 Nachkommastellen hat, die mittels dec_point anstelle des Punktes (".") von der Zahl getrennt werden, und deren Tausenderstellen mittels thousands_sep anstelle des Kommas (",") gruppiert werden.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Formats a number as a currency string
 
Gibt einen formatierten String zurück
 
Gibt einen formatierten String aus
 
Überträgt einen String in ein angegebenes Format
 

number_format() - Beispiel:


Eingabe:
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
?>


Ausgabe:
1,235

1 234,56

1234.57

Beschreibung:
Version Beschreibung
5.4.0 In dec_point und thousands_sep werden nun auch mehrere Bytes unterstützt. In vorherigen Versionen wurde jeweils nur das erste Byte genutzt.
String-Funktionen