開票據、寫支票或製作正式文件時,金額需要以中文大寫表示。以下這個函式利用字串處理與正規表達式,把數字轉為「壹、貳、參…」形式,並自動處理「十、百、千、萬、億」等單位。
function intToChinese(str) {
str = str + '';
var len = str.length - 1;
var idxs = ['', '十', '百', '千', '萬', '十', '百', '千', '億',
'十', '百', '千', '萬', '十', '百', '千', '億'];
var num = ['零', '壹', '貳', '三', '肆', '伍', '陸', '柒', '捌', '玖'];
return str.replace(/([1-9]|0+)/g, function ($, $1, idx, full) {
var pos = 0;
if ($1[0] != '0') {
pos = len - idx;
if (idx == 0 && $1[0] == 1 && idxs[len - idx] == '十') {
return idxs[len - idx]; // 開頭的「一十」省略為「十」
}
return num[$1[0]] + idxs[len - idx];
} else {
var left = len - idx;
var right = len - idx + $1.length;
if (Math.floor(right / 4) - Math.floor(left / 4) > 0) {
pos = left - left % 4;
}
if (pos) {
return idxs[pos] + num[$1[0]];
} else if (idx + $1.length >= len) {
return '';
} else {
return num[$1[0]];
}
}
});
}
idxs 是單位表,索引 0 對應個位(空字串),1 是十、2 是百、3 是千,4 是萬,之後每四位一循環,一路到億。num 則是數字對照表。
核心技巧是用正規表達式 /([1-9]|0+)/g 把數字切成「非 0 的單一字元」與「連續的 0」兩類片段,再對每個片段決定要輸出什麼。遇到非零數字時,用 len - idx 算出它所在的位數,從單位表取出對應字元;遇到一串 0 時,則要判斷是否跨過了「萬」或「億」的段落邊界——若是,就得補上該大單位並輸出一個「零」,否則在尾端就直接省略。
程式碼中還有一個貼心處理:當最開頭是「一十」時只輸出「十」,符合中文書寫習慣(唸「十二」而非「一十二」)。
這個實作有幾點需要留意,正式使用前建議補強:
第一,數字對照表中「貳」之後混入了簡體的「三」,若要全篇統一的財務大寫,應改為「參」。
第二,函式只處理整數,沒有小數部分。金額應用時通常還需要加上「元、角、分、整」等單位,並處理到小數點後兩位。
第三,因為 JavaScript 的 Number 精度上限為 2^53,超過此範圍的長數字(例如某些帳號)若先經過 Number 型別會失真,務必全程以字串處理。
第四,中文大寫金額有明確的書寫規範(例如連續多個零的省略規則、末位為零的處理),若要用於正式單據,建議對照相關會計書寫要點逐一驗證邊界情況,或改用經過驗證的成熟轉換程式庫。