常用函數對比表
| 函數 | 功能 | 示例 | 結果 | 備註 |
sprintf("%.nF", $num) | 格式化輸出,保留 n 位小數,**四捨五入** | sprintf("%.3f", 0.0215489) | "0.022" | 返回字符串,適合顯示 |
number_format($num, n) | 格式化數字,可加千分位,四捨五入 | number_format(1234.567, 2) | "1,234.57" | 返回字符串,支持自定義分隔符 |
round($num, n) | 四捨五入到 n 位小數,**返回 float** | round(1.95583, 2) | 1.96 | n 可為負數(十位、百位) |
ceil($num) | 向上取整(進一法) | ceil(4.3) | 5 | 分頁計算常用 |
floor($num) | 向下取整(捨去法) | floor(9.999) | 9 | |
intval($num) / (int)$num | 截取整數部分(向零取整) | intval(-4.9) | -4 | 負數時與 floor 不同 |
詳細示例
1. 保留 3 位小數四捨五入
$num = 0.0215489;
echo sprintf("%.3f", $num); // 0.022 (字符串)
echo round($num, 3); // 0.022 (float)
2. 保留 3 位小數**不**四捨五入(截斷)
$num = 0.0215489;
// 方法:保留 n+1 位再截斷
echo substr(sprintf("%.4f", $num), 0, -1); // 0.021
// 或數學方法
echo floor($num * 1000) / 1000; // 0.021
3. 進一法取整(分頁總頁數計算)
$totalItems = 105; $perPage = 20;
$totalPages = ceil($totalItems / $perPage); // 6
echo ceil(4.3); // 5
echo ceil(9.999); // 10
4. 捨去法取整
echo floor(4.3); // 4
echo floor(9.999); // 9
5. round() 進階行為
echo round(3.4); // 3
echo round(3.5); // 4 (PHP 遵循「銀行家捨入」?實際為遠離零方向,3.5→4, -3.5→-4)
echo round(3.6); // 4
echo round(3.6, 0); // 4
echo round(1.95583, 2); // 1.96
echo round(1241757, -3); // 1242000 (精度到千位)
echo round(5.045, 2); // 5.05
echo round(5.055, 2); // 5.06 (注意浮點數精度問題,5.055 實際存儲可能略大)
浮點數精度陷阱與解決
$a = 0.1; $b = 0.7;
echo ($a + $b) == 0.8 ? 'true' : 'false'; // false! (0.7999999999999999)
// 解決方案:
// 1. BCMath 高精度庫 (需擴展)
echo bcadd('0.1', '0.7', 1); // "0.8"
echo bccomp(bcadd('0.1', '0.7', 10), '0.8', 10) == 0; // true
// 2. 整數運算(金額轉分)
$price1 = 10; // 0.10 元 -> 10 分
$price2 = 70; // 0.70 元 -> 70 分
$sumCents = $price1 + $price2; // 80 分
echo $sumCents / 100; // 0.8
// 3. round() 修正比較
echo round($a + $b, 10) == 0.8; // true (足夠精度下)
最佳實踐建議
- 金額/財務計算**:唯一單位用**分(整數)**,或使用 **BCMath/GMP** 擴展。
- 顯示格式化**:用 `number_format()` 或 `sprintf()` 輸出字符串,不再用於計算。
- 分頁/分組**:用 `ceil()` 向上取整。
- 比較浮點數**:設定容差 `abs($a - $b) < 1e-9` 或用 `round($a, 10) === round($b, 10)`。
- 避免 `float` 作數組鍵/緩存鍵**:精度問題導致匹配失敗。