此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Number.parseInt()

基线 广泛可用

自 2015年9月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Number.parseInt() 静态方法解析一个字符串参数并返回一个指定基数的整数。

尝试一下

function roughScale(x, base) {
  const parsed = Number.parseInt(x, base);
  if (Number.isNaN(parsed)) {
    return 0;
  }
  return parsed * 100;
}

console.log(roughScale(" 0xF", 16));
// Expected output: 1500

console.log(roughScale("321", 2));
// Expected output: 0

语法

js
Number.parseInt(string)
Number.parseInt(string, radix)

参数

string

要被解析的值,会被强制转化为字符串。字符串开头的空白符将会被忽略。

radix 可选

236 之间的整数,表示 string基数(数学记数系统中的基)。

如果 radixundefined0,则 radix 将被默认设置为 10,除非该数字以码元对 0x0X 开头,在这种情况下,radix 将被默认设置为 16

返回值

从给定的 string 中解析出的一个整数。

如果 radix 小于 2 或大于 36,或第一个非空白字符不能转换为数字,则返回 NaN

示例

Number.parseInt 与 parseInt 对比

这个方法和全局的 parseInt() 函数具有相同的功能:

js
Number.parseInt === parseInt; // true

其目的是对全局变量进行模块化,另见 parseInt() 获取更多详情和示例。

规范

规范
ECMAScript® 2027 Language Specification
# sec-number.parseint

浏览器兼容性

参见