NumberFormatter::format()函数—用法及示例

函数名称：NumberFormatter::format()

适用版本：PHP 5 >= 5.3.0, PHP 7, PHP 8

函数描述：NumberFormatter::format() 函数用于将数字格式化为字符串。

语法：string NumberFormatter::format ( mixed $value [, int $type ] )

参数：

• $value：要格式化的数字。可以是整数、浮点数或一个 NumberFormatter 对象。
• $type（可选）：指定返回的格式类型，可以是以下常量之一：
  • NumberFormatter::TYPE_DEFAULT：默认格式化类型。
  • NumberFormatter::TYPE_INT32：将数字格式化为 32 位整数。
  • NumberFormatter::TYPE_INT64：将数字格式化为 64 位整数。
  • NumberFormatter::TYPE_DOUBLE：将数字格式化为浮点数。
  • NumberFormatter::TYPE_CURRENCY：将数字格式化为货币值。
  • NumberFormatter::TYPE_PERCENT：将数字格式化为百分比。

返回值：返回格式化后的字符串，如果格式化失败则返回 FALSE。

示例：

$formatter = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
$value = 12345.67;

// 格式化为默认类型
$result = $formatter->format($value);
echo $result;  // 输出：12,345.67

// 格式化为整数类型
$result = $formatter->format($value, NumberFormatter::TYPE_INT32);
echo $result;  // 输出：12,345

// 格式化为货币类型
$result = $formatter->format($value, NumberFormatter::TYPE_CURRENCY);
echo $result;  // 输出：$12,345.67

// 格式化为百分比类型
$result = $formatter->format($value, NumberFormatter::TYPE_PERCENT);
echo $result;  // 输出：1,234,567%

注意事项：

• NumberFormatter 类需要 intl 扩展的支持，确保已启用该扩展。
• 格式化字符串的形式、千位分隔符和小数点符号等取决于设置的区域设置（locale）和 NumberFormatter 类型。
• 可以使用 NumberFormatter::parse() 函数将格式化后的字符串解析回数字。