toFixed() 是 Number 原型上的方法,用來把數字轉成「具有指定小數位數」的字串。它是格式化金額、百分比、測量值時最常用的工具。
<script>
var a = 4.2343;
alert(a.toFixed(3));
</script>
執行結果是 4.234。它會四捨五入到小數第三位,並回傳字串(不是數字)。
number.toFixed(digits)
digits 是 0 到 100 之間的整數(舊規格上限為 20)。幾個要留意的行為:
(4.2343).toFixed(2) // "4.23"
(4.2).toFixed(2) // "4.20" 會補零到指定位數
(4).toFixed(2) // "4.00"
(4.235).toFixed(2) // "4.24"
(1.005).toFixed(2) // "1.00" ← 精度問題,見下文
(4.2343).toFixed(0) // "4" 不帶小數點
(-1.5).toFixed(0) // "-2"
關鍵點:回傳值是字串。若要繼續做數值運算,必須用 Number() 或 parseFloat() 轉回數字:
var str = (4.2343).toFixed(2); // "4.23"
str + 1; // "4.231" ← 字串串接,不是加法!
Number(str) + 1; // 5.23 ← 正確
parseFloat(str) + 1; // 5.23
這是最常見的 bug:忘記 toFixed 回傳字串,導致後續的加法變成串接。
這段程式看起來應該得到 1.01,實際卻是 1.00:
(1.005).toFixed(2) // "1.00" 預期 "1.01"
原因是 IEEE 754 浮點數無法精確表示 1.005,它實際儲存的值略小於 1.005(約 1.00499999...),所以四捨五入後就變成 1.00。同理:
(0.1 + 0.2).toFixed(1) // "0.3" 看起來正常
0.1 + 0.2 === 0.3 // false 實際是 0.30000000000000004
這不是 JavaScript 的 bug,所有語言用雙精度浮點數都一樣。
若你需要在金流、會計這類對精度敏感的場景使用,建議用以下方式避開浮點誤差:
// 方式一:用整數運算避開浮點(推薦給貨幣計算)
function roundTo(value, digits){
var factor = Math.pow(10, digits);
return Math.round(value * factor) / factor;
}
roundTo(1.005, 2); // 1.01
// 方式二:轉成指數記法處理(較通用)
function roundTo(value, digits){
return Number(Math.round(value + 'e' + digits) + 'e-' + digits);
}
roundTo(1.005, 2); // 1.01
方式二的原理是透過字串把小数點暫時移開,讓 Math.round 處理整數部分,再移回來。
如果只是要顯示金額,Intl.NumberFormat 會做得比 toFixed 好得多——它自帶千分位分隔符、貨幣符號、本地化:
// 千分位 + 兩位小数
new Intl.NumberFormat('zh-TW', {
minimumFractionDigits: 2,
maximumFractionDigits: 2
}).format(1234567.891);
// "1,234,567.89"
// 貨幣格式
new Intl.NumberFormat('zh-TW', {
style: 'currency', currency: 'TWD'
}).format(1234.5);
// "NT$1,234.50"
// 百分比
new Intl.NumberFormat('zh-TW', { style: 'percent' }).format(0.256);
// "25.6%"
// 若要拿回數字而非字串
new Intl.NumberFormat('zh-TW', { maximumFractionDigits: 2 })
.formatToParts(1234.5678);
要注意 toFixed 不會加千分位,(1234567.891).toFixed(2) 得到的是 "1234567.89",正式介面顯示時通常需要加上逗號。
// 自製千分位
function formatNumber(n, digits){
return n.toFixed(digits || 0)
.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
}
formatNumber(1234567.891, 2); // "1,234,567.89"
那個正則 /\B(?=(\d{3})+(?!\d))/g 是經典的千分位寫法,在每個「後面剛好是三的倍數位數字」的非邊界位置插入逗號。
Number() 轉回來,不然會踩到字串串接的坑。