Funkce number_format

Funkce number_format umožňuje formátovat číslo. Hlavně se používá k tomu, aby oddělovala trojice čísel mezerami, například z 1234567 může udělat 1 234 567.

Kromě toho funkce umožňuje regulovat počet číslic za desetinnou částí. Tento počet je zadán druhým volitelným parametrem.

Například, ze zlomku 12345.6789 lze vytvořit zlomek 12 345.68 - funkce umístí mezery mezi trojice a zaokrouhlí zlomek na dvě číslice v desetinné části.

Třetí volitelný parametr nastavuje oddělovač desetinné části (ve výchozím nastavení tečka, ale lze změnit). Nutně spolu s třetím parametrem musí být i čtvrtý - ten nastavuje oddělovač trojic čísel (ve výchozím nastavení čárka, ale lze změnit, například na mezeru). To znamená, že ve výchozím nastavení funkce odděluje trojice čárkami: z 1234567 udělá 1,234,567.

Syntaxe

number_format(float $num, int $decimals = 0, ?string $decimal_separator = ".", ?string $thousands_separator = ","): string

number_format(číslo, počet číslic);

number_format(číslo, počet číslic, oddělovač desetinné části, oddělovač tisíců);

Příklad

Pojďme oddělit trojice čísel čárkou:

<?php
	echo number_format(1234567);
?>

Výsledek provedení kódu:

'1,234,567'

Příklad

Pojďme oddělit trojice čísel čárkou, a desetinnou část zaokrouhlit na dvě číslice:

<?php
	echo number_format(1234.567, 2);
?>

Výsledek provedení kódu:

'1,234.57'

Příklad

Pojďme oddělit trojice čísel mezerou, a desetinnou část zaokrouhlit na dvě číslice, a oddělovač desetinné části udělat lomítko:

<?php
	echo number_format(1234.567, 2, '/', ' ');
?>

Výsledek provedení kódu:

1 234/57

Příklad

Pojďme oddělit trojice čísel mezerou, desetinnou část zaokrouhlit na dvě číslice, oddělovač desetinné části udělat tečku:

<?php
	echo number_format(1234.567, 2, '.', ' ');
?>

Výsledek provedení kódu:

1 234.57

Viz také

funkci printf,
která formátuje řetězec