PHP 採用 IEEE 754 雙精度浮點數,二進制無法精確表示許多十進制小數(如 0.1、0.7),導致計算誤差:
<?php
echo 0.1 + 0.2; // 0.30000000000000004
echo (int)(0.58 * 100); // 57(非 58)!
?>
<?php
echo round(3.4); // 3
echo round(3.5); // 4
echo round(3.14159, 2); // 3.14
echo round(12345, -2); // 12300(負精度:捨入到百位)
// 模式控制(PHP 5.3+)
echo round(1.5, 0, PHP_ROUND_HALF_UP); // 2(預設:四捨五入)
echo round(1.5, 0, PHP_ROUND_HALF_DOWN); // 1(五捨六入)
echo round(1.5, 0, PHP_ROUND_HALF_EVEN); // 2(銀行家捨入:捨入到最鄰近偶數)
echo round(2.5, 0, PHP_ROUND_HALF_EVEN); // 2
?>
<?php
$n = 12.338938438;
echo sprintf("%.5f", $n); // 12.33894(四捨五入到小數 5 位)
echo sprintf("%.2f", $n); // 12.34
// 格式化金額:千分位 + 固定 2 位小數
echo sprintf("%0.2f", 1234.5); // 1234.50
?>
注意:sprintf() 回傳字串,非數值,不可直接參與運算。
<?php
$num = 1234567.89123;
// 基本用法
echo number_format($num); // 1,234,568(預設 0 位小數,四捨五入)
echo number_format($num, 2); // 1,234,567.89
echo number_format($num, 2, '.', ','); // 1,234,567.89(自訂小數點、千分位符號)
echo number_format($num, 2, '.', ' '); // 1 234 567.89(法式空格分隔)
// 歐洲格式:逗號為小數點,點為千分位
echo number_format($num, 2, ',', '.'); // 1.234.567,89
?>
PHP 內建函數皆為四捨五入,若需截斷(向零捨入),需自訂函數:
<?php
function truncateFloat($value, int $decimals): string {
$str = (string)$value;
if (($pos = strpos($str, '.')) === false) return $str;
return substr($str, 0, $pos + 1 + $decimals);
}
echo truncateFloat(12.9999, 2); // "12.99"
echo truncateFloat(12.9, 4); // "12.9"(不足位數不補零)
?>
<?php
function floorFloat($value, int $decimals): float {
$factor = 10 ** $decimals;
return floor($value * $factor) / $factor;
}
function ceilFloat($value, int $decimals): float {
$factor = 10 ** $decimals;
return ceil($value * $factor) / $factor;
}
echo floorFloat(12.9999, 2); // 12.99
echo ceilFloat(12.9901, 2); // 12.99
?>
<?php
// 需安裝 bcmath 擴充
echo bcdiv('12.9999', '1', 2); // 12.99(截斷)
echo bcadd('0.1', '0.2', 10); // 0.3000000000(精確加法)
?>
DECIMAL(10,2) 或 整數分單位(如 12345 代表 123.45 元)。bcmath 擴充。number_format($cents / 100, 2, '.', ',')。| 需求 | 推薦函數 | 備註 |
|---|---|---|
| 四捨五入到 N 位小數(數值) | round($v, $n) | 支援模式控制 |
| 格式化顯示:固定小數位+千分位 | number_format($v, $n, '.', ',') | 回傳字串 |
| 格式化輸出到字串(C 風格) | sprintf("%.{$n}f", $v) | 回傳字串 |
| 截斷(不四捨五入)顯示 | 自訂 truncateFloat() | 回傳字串 |
| 截斷(不四捨五入)運算 | 自訂 floorFloat() | 回傳 float |
| 高精度金融運算 | BCMath 函數 | 需擴充,字串運算 |