把 1234567.891 顯示成 1,234,567.89,這件事看起來簡單,實際上要處理的邊界情況不少:空值、非數字、已經有千分位、負數、指定小數位數。下面這個函式把這些都收攏在一起,並用「格式範本」的方式決定輸出的樣子。
/**
* 格式化數字
* 參數:
* prmNum (Number) 要格式化的數字
* prmPtn (String) 格式化規則,例如:#,##0.00
* prmNullValue 當傳入值為 null、空或非數字時的回傳結果,預設 0
*/
function formatNum(prmNum, prmPtn, prmNullValue){
var nullValue = prmNullValue ? prmNullValue : 0;
if(prmNum == "" || prmNum == null) return nullValue;
prmNum = prmNum.replace(/\,/g, ""); // 先清掉既有的千分位
if(isNaN(prmNum)) return nullValue;
if(prmPtn == "" || prmPtn == null) return prmNum;
var ptnLen = prmPtn.length;
var pointIndex = prmPtn.indexOf(".");
var groupIndex = prmPtn.indexOf(",");
// 由範本推得小數位數
var pointLen = (pointIndex == -1 ? 0 : ptnLen - pointIndex - 1);
prmNum = parseFloat(prmNum).toFixed(pointLen) + "";
if(groupIndex != -1){
if(pointIndex == -1) pointIndex = ptnLen;
// 每幾位加一個逗號,由範本中逗號的位置決定
var len = pointIndex - groupIndex - 1;
var reg = new RegExp("(-?\\d+)(\\d{" + len + "})");
while(reg.test(prmNum)) prmNum = prmNum.replace(reg, "$1,$2");
}
return prmNum;
}
nullValue;接著把可能已存在的逗號去掉,再用 isNaN 確認真的是數字。這一步很重要——使用者從輸入框貼上來的「1,234」很常見。#,##0.00 中,小數點在索引 6、總長 8,所以小數位是 8 - 6 - 1 = 2。用 toFixed() 完成(順便做了四捨五入)。len = pointIndex - groupIndex - 1。以 #,##0.00 而言是 6 - 1 - 1 = 4... 這裡要留意,原版的計算方式在這個範本下得到 4 而非 3,實務上多數人會直接寫死 3 位一組。/(-?\d+)(\d{3})/ 每次從右端切出三位加上逗號,用 while 迴圈跑到不能再切為止。-? 是為了讓負號不被當成數字的一部分而错位。$1 代表第一個捕獲群組、$2 代表第二個,這是正則替換最實用的語法之一。今天不需要自己刻這個輪子。Intl.NumberFormat 是標準 API,處理千分位、小數位、貨幣符號、百分比、 locales 差異全部包含在內:
// 千分位 + 兩位小數
new Intl.NumberFormat('zh-TW', {
minimumFractionDigits: 2,
maximumFractionDigits: 2
}).format(1234567.891); // "1,234,567.891" → "1,234,567.89"
// 貨幣
new Intl.NumberFormat('zh-TW', {
style: 'currency', currency: 'TWD'
}).format(1234567.891); // "NT$1,234,567.891" → 依 locale 格式化
// 若要完全由範本字串驅動,也可以解析範本後組出 options
function formatByPattern(num, pattern) {
var parts = pattern.split('.');
var grouped = parts[0].indexOf(',') != -1;
var decimals = parts[1] ? parts[1].length : 0;
return new Intl.NumberFormat('en-US', {
useGrouping: grouped,
minimumFractionDigits: decimals,
maximumFractionDigits: decimals
}).format(Number(num));
}
自己實作的價值在於理解背後發生了什麼:小數位數的推算、正則的分割與重組、以及為什麼要先清掉既有分隔符號。但正式專案請用 Intl——它正確處理各地區的數字系統差異,這是自己刻不出來的。