parseInt() 用來解析字串並回傳一個整數。它看起來簡單,但第二個參數與開頭格式會帶來一些出乎意料行為,值得完整理解一次。
parseInt(string, type)
| 參數 | 說明 |
|---|---|
| string | 必填。要被解析的字串。 |
| type | 可選。指定解析時使用的基數(進位制),例如二進位、八進位或十六進位,值介於 2 到 36 之間。 |
函式會依指定的進位來解析字串:
parseInt("010", 10); // 10,視為十進位
parseInt("010", 2); // 2,視為二進位
parseInt("010", 8); // 8,視為八進位
parseInt("010", 16); // 16,視為十六進位
要注意兩件事:
回傳值一律是十進位。type 指定的是「輸入字串的進位」,不是輸出的進位。想把結果轉成其他進位,要再串上 .toString(radix)。
type 超出 2 到 36 的範圍會回傳 NaN。
遇到非數字字元就停下來。函式只解析到第一個不合法的位為止,後面全部忽略:
parseInt("123ab789", 10); // 123,遇到 a 就停止
如果字串第一個字元就不是合法數字,結果自然是 NaN。
這是最容易出事的地方。函式會自行猜測進位,通常判定為十進位:
parseInt("23"); // 23
parseInt("23ab"); // 23
但有兩種開頭格式會讓它改弦易轍:
以 "0x" 開頭 → 視為十六進位。
parseInt("0x12"); // 18,而非 0
這時「遇到第一個非數字就停」的規則不適用,因為 0x 是公認的十六進位前綴。
以 "0" 開頭且後面緊接數字 → 依瀏覽器而異。舊標準把這種寫法當成八進位前綴,於是:
parseInt("0123"); // Chrome 回傳 123,舊版 IE 回傳 83
83 是 0123 按八進位解析的結果。同一行程式碼在不同瀏覽器給出不同答案,這正是為什麼永遠應該明確傳入第二個參數:
parseInt(value, 10); // 永遠當十進位處理,行為可預測
parseInt 會截斷而非四捨五入。parseInt("3.99") 得到 3。要四捨五入請用 Math.round()。
要轉換數字而非解析字串時,用 Number() 更合適。Number("3.99") 得到 3.99,而 Number("123ab") 得到 NaN 而非 123。兩者的差別在於:parseInt 是「盡力解析字串開頭」,Number 是「整個值必須是合法數字」。需要哪一種行為,取決於你的資料來源。
大整數有精度限制。JavaScript 的 Number 只能精確表示 2 的 53 次方以內的整數,超出範圍會失真。處理身分證號、手機號碼這類長數字時,建議全程當字串處理,不要轉成數字。
最後,ES5 之後標準已明定未指定 radix 時一律以 10 為預設(除了 0x 前綴),所以現代瀏覽器的行為其實是一致的。但加上 , 10 幾乎沒有成本,卻能讓程式碼在任何環境下都保持正確——這是值得養成的習慣。