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() 函式將格式化後的字串解析回數字。