做報表時經常會遇到一個小需求:把 1234.56 這種阿拉伯數字,變成「壹仟貳佰參拾肆元伍角陸分」這樣的中文大寫。作者當年寫了一個自己覺得有點醜但堪用的版本(2003 年 7 月 31 日),這裡整理一下其中的關鍵思路。
中文金額大寫的用途是防篡改。「一」加一筆就成了「二」或「十」,但「壹」很難改。這就是為什麼支票、發票、契約上的金額總要用大寫,並在末尾加上「整」字。
核心是一組查表。數字部分:0 到 9 對應 零、壹、貳、參、肆、伍、陸、柒、捌、玖。
整位單位從小到大是 分、角、元,然後是 拾、佰、仟 這組小單位,再往上才是 萬、億、兆 這組大單位。小單位每三位循環一次,大單位則是每一萬進一階。
理解這個結構很重要,因為它決定了程式的分組方式:整數部分要從右往左每四位切一組,組內套小單位,組尾接大單位。
第一,零的處理。連續的零只能念一個,而且有些零要省略不念。例如 1005 唸「壹仟零伍」,中間的兩個零合為一個;但 1050 唸「壹仟零伍拾」,尾部的零則不發音。這是最容易寫錯的部分,通常需要用一個旗標記錄「上一個位置是否輸出過零」。
第二,尾部的「整」。若金額沒有角與分,要在最後補上「整」或「正」。若有角有分則不加。若只有分沒有角,習慣上要唸「零几分」。
第三,浮點數誤差。絕對不要用浮點運算處理金額。0.1 加 0.2 在 JavaScript 裡不等於 0.3。正確做法是把金額先乘以 100 轉成整數(以「分」為單位)來運算,最後再格式化輸出。
第四,負數與千分位。輸入可能帶小數點、逗號、貨幣符號或前置負號,正式實作前應該先做一次清洗與合法性驗證,否則後面的查表邏輯會拿到意料之外的值。
与其写一大堆 if 判斷,不如反過來想:先不管零,把每個位數都如實轉成「數字 + 單位」的列表,最後再用一次後處理把多餘的零合併掉。這樣主邏輯會非常短,特殊情況集中在單一處處理,測試也好寫。
另外強烈建議為這個函式補上測試案例,至少涵蓋:整數、只有角、只有分、含連續零、最大值、零本身、負數。這類字串轉換的邊界情況很多,靠肉眼檢查很容易漏。