萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 浮點數精度處理:round、sprintf、number_format 與自訂截斷函數

浮點數精度問題根源

PHP 採用 IEEE 754 雙精度浮點數,二進制無法精確表示許多十進制小數(如 0.1、0.7),導致計算誤差:

<?php
echo 0.1 + 0.2; // 0.30000000000000004
echo (int)(0.58 * 100); // 57(非 58)!
?>

四捨五入函數對比

1. round($val, $precision = 0, $mode = PHP_ROUND_HALF_UP)

<?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
?>

2. sprintf() / printf() 格式化輸出

<?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() 回傳字串,非數值,不可直接參與運算。

3. number_format() 千分位與小數位格式化

<?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
?>

方法三:BCMath 高精度(金融級)

<?php
// 需安裝 bcmath 擴充
echo bcdiv('12.9999', '1', 2); // 12.99(截斷)
echo bcadd('0.1', '0.2', 10);  // 0.3000000000(精確加法)
?>

金額計算最佳實踐

  1. 資料庫儲存:用 DECIMAL(10,2) 或 整數分單位(如 12345 代表 123.45 元)。
  2. PHP 運算:整數分單位運算,或使用 bcmath 擴充。
  3. 顯示:number_format($cents / 100, 2, '.', ',')。
  4. 避免:直接用 float 進行金額加減乘除。

函數選擇速查表

需求推薦函數備註
四捨五入到 N 位小數(數值)round($v, $n)支援模式控制
格式化顯示:固定小數位+千分位number_format($v, $n, '.', ',')回傳字串
格式化輸出到字串(C 風格)sprintf("%.{$n}f", $v)回傳字串
截斷(不四捨五入)顯示自訂 truncateFloat()回傳字串
截斷(不四捨五入)運算自訂 floorFloat()回傳 float
高精度金融運算BCMath 函數需擴充,字串運算
copyright © 萬盛學電腦網 all rights reserved