PHP 提供多種數值格式化與四捨五入方式,適用場景各異。本文對比 number_format()、round()、sprintf() 三大函數的行為差異、精度陷阱與最佳實踐。
$number = 1234.5678;
// 法文格式:空格分組、逗號小數點
$fr = number_format($number, 2, ',', ' '); // "1 234,57"
// 英文格式:無分組、點號小數點
$en = number_format($number, 2, '.', ''); // "1234.57"
// 只保留兩位小數,不加千分位
$simple = number_format($number, 2, '.', ''); // "1234.57"
特點:回傳字串、支援自訂千分位/小數點符號、內建四捨五入。
陷阱:number_format(1.005, 2) 回傳 "1.00"(浮點數精度問題),非 "1.01"。
$number = 1234.5678;
echo round($number, 2); // 1234.57 (float)
echo round(1.005, 2); // 1.00 — 同樣受浮點數精度影響
echo round(1.015, 2); // 1.02
進階模式(PHP 5.3+):
round(1.5, 0, PHP_ROUND_HALF_UP); // 2 四捨五入(預設)
round(1.5, 0, PHP_ROUND_HALF_DOWN); // 1 五捨六入
round(1.5, 0, PHP_ROUND_HALF_EVEN); // 2 銀行家捨入(偶數優先)
round(1.5, 0, PHP_ROUND_HALF_ODD); // 1 奇數優先
回傳 float,後續可直接參與運算。
$name = '張三';
$money = 123.1;
$formatted = sprintf("%s有¥%01.2f。", $name, $money);
// "張三有¥123.10。"
常用格式佔位符:
| 格式 | 說明 | 範例 |
|---|---|---|
%f | 浮點數(預設 6 位小數) | sprintf("%f", 1.2) → "1.200000" |
%.2f | 保留 2 位小數,四捨五入 | sprintf("%.2f", 1.234) → "1.23" |
%01.2f | 總寬度≥1、2位小數、不足前補 0 | sprintf("%01.2f", 1.2) → "1.20" |
%d | 整數 | sprintf("%d", 3.9) → "3" |
IEEE 754 二進制浮點數無法精確表示 0.1、0.01 等十進制小數:
var_dump(1.005 * 100); // float(100.49999999999999) 非 100.5
bcadd()、bcmul()、bcdiv() 字串運算,任意精度。| 場景 | 推薦函數 | 理由 |
|---|---|---|
| 金額顯示(含千分位、貨幣符號) | number_format() | 內建分組符號、字串輸出直觀 |
| 數學運算中間結果捨入 | round() | 回傳 float、支援多種捨入模式 |
| 報表、日誌、模板輸出 | sprintf() | 格式化能力最強、可嵌入字串 |
| 財務級精度計算 | BCMath / 整數分 | 避免浮點數誤差 |