number_format

(PHP 4, PHP 5, PHP 7, PHP 8)

number_format — 以千位分隔符方式格式化一个数字

说明

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

使用四舍五入的规则，将数字格式化为千位分组和小数位（可选）。

参数

num

要格式化的数字。

decimals

设置小数位数。如果为 0，则从返回值中忽略 decimal_separator。

decimal_separator

指定小数点的分隔符。

thousands_separator

设置千位分隔符。

返回值

num 的格式化版本。

更新日志

版本 说明
8.0.0 在此版本之前，number_format() 接受一个、两个或四个参数（不会是三个）。
7.2.0 number_format() 现在再也不会返回 -0，之前 num 为 -0.01 的情况下可以返回 -0。

示例

示例 #1 number_format() 示例

例如，法语计数通常使用两位小数，逗号（“,”）作为小数分隔符，空格（“ ”）作为千位分隔符。以下示例展示了格式化数字的各种方法：

<?php

$number = 1234.56;

// 英文计数（默认）
$english_format_number = number_format($number);
// 1,235

// 法语计数
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56

$number = 1234.5678;

// 没有千位分隔符的英文计数
$english_format_number = number_format($number, 2, '.', '');
// 1234.57

?>

参见