將數字字串每三位插入逗號(千分位格式)是金融、報表常見需求。本文從簡單的內建函數進階到通用的分組函數,涵蓋各種邊界情況。
<?php $number = 1234567890.12345; // 基本用法:整數部分每三位逗號,小數點預設為點 echo number_format($number); // 1,234,567,890 echo number_format($number, 2); // 1,234,567,890.12 echo number_format($number, 2, ',', '.'); // 歐洲格式:1.234.567.890,12 // 注意:超大數字會科學記號法,建議字串處理 $big = '12345678901234567890'; echo number_format($big); // 可能不準確 ?>
<?php
/**
* 從右向左每 $length 字元插入 $separator
* 適用於數字字串、身分證字號、信用卡號等格式化
*
* @param string $str 原始字串
* @param int $length 分組長度
* @param string $separator 分隔符
* @return string 格式化後字串
*/
function chunkString(string $str, int $length = 3, string $separator = ','): string {
if ($length <= 0) {
throw new InvalidArgumentException('分組長度必須大於 0');
}
// 處理負號與小數點
$prefix = '';
if (str_starts_with($str, '-')) {
$prefix = '-';
$str = substr($str, 1);
}
// 分離整數與小數部分
$parts = explode('.', $str, 2);
$integerPart = $parts[0];
$decimalPart = $parts[1] ?? '';
// 從右向左分組整數部分
$reversed = strrev($integerPart);
$chunks = str_split($reversed, $length);
$formattedInteger = strrev(implode($separator, $chunks));
// 組合結果
$result = $prefix . $formattedInteger;
if ($decimalPart !== '') {
$result .= '.' . $decimalPart;
}
return $result;
}
// 測試
echo chunkString('1234567890') . "\n"; // 1,234,567,890
echo chunkString('1234567890.123', 3, ',') . "\n"; // 1,234,567,890.123
echo chunkString('-1234567890', 3, ',') . "\n"; // -1,234,567,890
echo chunkString('1234567890', 4, ' ') . "\n"; // 1 2345 6789 (四位一組)
echo chunkString('A123456789', 3, '-') . "\n"; // A12-345-6789 (身分證格式)
?>
<?php
function formatWithRegex(string $number): string {
// 從右向左每三位插入逗號(不影響小數部分)
return preg_replace('/(\d)(?=(\d{3})+(?!\d))/', '$1,', $number);
}
echo formatWithRegex('1234567890'); // 1,234,567,890
echo formatWithRegex('1234567890.123'); // 1,234,567,890.123
echo formatWithRegex('-1234567890'); // -1,234,567,890
// 解釋正則:
// (\d) 捕獲一個數字
// (?= 正向前瞻
// (\d{3})+ 後面跟著 3 的倍數個數字
// (?!\d) 但後面不能再有數字(確保是整數部分結尾)
// )
?>
原文程式碼使用雙層迴圈手動翻轉字串,存在以下問題:
$j 在內層迴圈後狀態不明確| 方法 | 相對速度 | 適用場景 |
|---|---|---|
| number_format() | 最快(C 層實作) | 純數字格式化 |
| preg_replace() | 中等 | 字串已知為純數字、需簡潔程式碼 |
| strrev + str_split + implode | 中等 | 通用字串分組、自訂分隔符 |
| 雙層迴圈手動翻轉 | 最慢 | 教學示範、極特殊邏輯 |
function formatCreditCard(string $number): string {
// 移除所有非數字
$digits = preg_replace('/\D/', '', $number);
return chunkString($digits, 4, ' ');
}
echo formatCreditCard('4242-4242-4242-4242'); // 4242 4242 4242 4242
function formatTwId(string $id): string {
$id = strtoupper(preg_replace('/\s+/', '', $id));
if (strlen($id) !== 10) return $id;
return substr($id, 0, 1) . chunkString(substr($id, 1), 3, '-');
}
echo formatTwId('A123456789'); // A123-456-789
function formatPhone(string $phone): string {
$digits = preg_replace('/\D/', '', $phone);
// 09xx-xxx-xxx 或 02-xxxx-xxxx
if (str_starts_with($digits, '09')) {
return chunkString($digits, 3, '-', 0, 3); // 需擴充函數支援首段長度
}
return chunkString($digits, 4, '-');
}
number_format(),效能最好、功能最完整strrev() + str_split() + implode() 模式,清晰且效能佳preg_replace() 適合已知純數字字串