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 可选

2 到 36 之间的整数，表示 string 的基数（数学记数系统中的基）。

如果 radix 为 undefined 或 0，则 radix 将被默认设置为 10，除非该数字以码元对 0x 或 0X 开头，在这种情况下，radix 将被默认设置为 16。

返回值

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

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

示例

Number.parseInt 与 parseInt 对比

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

Number.parseInt === parseInt; // true

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

规范

ECMAScript® 2027 Language Specification
# sec-number.parseint

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题