DIV CSS 佈局教程網

寫一個 JavaScript 數字格式化函式,支援千分位與小數位
編輯:關於JavaScript     

把 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;
}

運作邏輯拆解

  1. 防禦性檢查:空字串與 null 直接回傳 nullValue;接著把可能已存在的逗號去掉,再用 isNaN 確認真的是數字。這一步很重要——使用者從輸入框貼上來的「1,234」很常見。
  2. 從範本推小數位數:#,##0.00 中,小數點在索引 6、總長 8,所以小數位是 8 - 6 - 1 = 2。用 toFixed() 完成(順便做了四捨五入)。
  3. 推千分位間隔:len = pointIndex - groupIndex - 1。以 #,##0.00 而言是 6 - 1 - 1 = 4... 這裡要留意,原版的計算方式在這個範本下得到 4 而非 3,實務上多數人會直接寫死 3 位一組。
  4. 反覆插入逗號:/(-?\d+)(\d{3})/ 每次從右端切出三位加上逗號,用 while 迴圈跑到不能再切為止。-? 是為了讓負號不被當成數字的一部分而错位。
  5. $1、$2 的用法:替換字串中的 $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——它正確處理各地區的數字系統差異,這是自己刻不出來的。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved