toFixed() 是 Number 原型的 method,用來把數字四捨五入為指定位數小數的字串。它常被拿來做金額與百分比格式化,但背後有幾個容易踩的細節。
toFixed() 可把 Number 四捨五入為指定小數位數的數字表示。
NumberObject.toFixed(num)
參數 num 為必需,規定小數的位數,是 0 到 20 之間的值(含 0 與 20),部分實作支援更大範圍。若省略該參數,等同傳入 0。
回傳 NumberObject 的字串表示,不採用指數計數法,小數點後有固定的 num 位數字。若必要,該數字會被捨入,也會用 0 補足位數以達到指定長度。
有個特殊情況值得記:如果 num 大於 le + 21(le 為該數字十進位表示時的指數),則該方法只呼叫 NumberObject.toString(),回傳採用指數計數法的字串。
當 num 太小或太大時丟出 RangeError;0 到 20 之間的值不會引發該例外。當呼叫該方法的物件不是 Number 時丟出 TypeError。
<script type="text/javascript"> var num = new Number(13.37); document.write(num.toFixed(1)); </script>
輸出結果:13.4
更多例子:
(3.14159).toFixed(2); // "3.14" (3.10).toFixed(4); // "3.1000",會補零 (1234.5).toFixed(0); // "1235" (-1.5).toFixed(0); // "-2"
這是最常見的誤會。toFixed() 回傳字串而非數字,因此不能直接拿來做算術運算:
(10).toFixed(2) + (20).toFixed(2); // "1020",字串串接而非加法 +(10).toFixed(2) + +(20).toFixed(2); // 30,用一元加號轉回數字
若只是要顯示,字串正好;若要繼續計算,記得轉回數字,或干脆只在輸出時才格式化。
由於浮點數無法精確表示某些小數,toFixed 的結果偶爾會與「學校教的四捨五入」不同:
(1.005).toFixed(2); // "1.00",而非 "1.01" (2.55).toFixed(1); // "2.5",而非 "2.6" (8.575).toFixed(2); // "8.57",而非 "8.58"
原因是 1.005 在記憶體中實際儲存的值略小於 1.005,因此捨去而非進位。這不是 bug,而是 IEEE 754 浮點表示的必然結果。
此外,toFixed 的採樣規則在遇到「剛好一半」時的處理,各家引擎歷史上並不一致,部分情況會出現向上、部分向下。
涉及金額等需要精確十進位運算的場景,建議改用整數運算:
function roundTo(num, digits) {
var base = Math.pow(10, digits);
return Math.round(Number(num + 'e' + digits)) + 'e-' + digits;
}
// 或
function roundTo(num, digits) {
var base = Math.pow(10, digits);
return Math.round((num * base).toFixed(8)) / base;
}
roundTo(1.005, 2); // 1.01
第一個版本用了「e 記數法位移」的技巧,把浮點問題暫時繞開;第二個版本則先把乘法結果丟給 toFixed(8) 清掉浮點尾數,再取整。兩者都能處理 1.005 這個經典案例。
若要進行真正的十進位運算(會計、金融系統),更根本的做法是以「分」為單位全程使用整數,或引入 decimal.js、big.js 這類專用的十進位函式庫。
toPrecision(n):指定總有效位數而非小數位數,適合科學記號的場景。(123.456).toPrecision(4) 為 "123.5"。
Intl.NumberFormat:現代瀏覽器內建,能自動處理千分位、貨幣符號與各地區格式,是顯示數字的首選:
new Intl.NumberFormat('zh-TW').format(1234567.891); // "1,234,567.891"
new Intl.NumberFormat('zh-TW', {
style: 'currency', currency: 'TWD'
}).format(1234.5); // "NT$1,234.50"
new Intl.NumberFormat('zh-TW', {
minimumFractionDigits: 2, maximumFractionDigits: 2
}).format(1234.5); // "1,234.50"
Math.round(x * 100) / 100:需要數字結果而非字串時,這是最簡短的寫法。
toFixed() 適合「把數字顯示成固定小數位」這個單純需求,但要記住三件事:回傳字串、遇浮點邊界值可能與直覺不符、它是格式化工具而非精算工具。真正的十進位運算請交給整數或專用函式庫。