HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.
View in English Always switch to English
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
A função parseInt() analisa um argumento string e retorna um inteiro na base especificada.
parseInt()
string
base
parseInt(string, base);
O valor a analisar. Se o argumento string não for uma string, então o valor é convertido para uma string (utilizando a operação abstrata ToString). Os espaços em branco na string são ignorados.
ToString
Um inteiro entre 2 e 36 que representa a base da string (sistemas numéricos matemáticos) mencionada no parâmetro anterior. Especifique 10 para o sistema numérico decimal comumente usado por humanos. Sempre especifique este parâmetro para eliminar confusão do leitor e para garantir o comportamento esperado. Implementações diferentes produzem resultados diferentes quando base não é especificado, normalmente assumindo o valor como 10.
2
36
10
Um número inteiro analisado a partir da string fornecida. Se o primeiro caracter não puder ser convertido para um número, NaN é retornado.
NaN
A função parseInt converte seu primeiro argumento para uma string, analisa, e retorna um inteiro ou NaN. Se não NaN, o valor retornado será a representação decimal inteira do primeiro argumento obtido como um número na base especificada. Por exemplo, umabase 10 indica para converter de um número decimal, 8 octal, 16 hexadecimal, e assim por diante. Para bases acima de 10, as letras do alfabeto indicam numerais maiores que 9. Por exemplo, para números hexadecimais (base 16), A até F são usados.
parseInt
9
A
F
Se parseInt encontrar um caracter que não seja um numeral na base especificada, ele o ignora e a todos os caracteres subsequentes e retorna o valor inteiro analisado até aquele ponto. parseInt trunca números para valores inteiros. Espaços no início e fim são permitidos.
Se base é undefined ou 0 (ou ausente), JavaScript assume o seguinte:
undefined
Se o primeiro caracter não puder ser convertido para um número, parseInt retorna NaN.
Para propósitos aritméticos, o valor NaN não é um número em qualquer base. Você pode chamar a função isNaN para determinar se o resultado de parseInt é NaN. Se NaN for passado em operações aritméticas, o resultado da operação também será NaN.
isNaN
Para converter um número para seu literal string em uma base específica use intValue.toString(base).
intValue.toString(base)
Os seguintes exemplos sempre retornam 15:
15
parseInt(" 0xF", 16); parseInt(" F", 16); parseInt("17", 8); parseInt(021, 8); parseInt("015", 10); parseInt(15.99, 10); parseInt("FXX123", 16); parseInt("1111", 2); parseInt("15*3", 10); parseInt("15e2", 10); parseInt("15px", 10); parseInt("12", 13);
Os seguintes exemplos sempre retornam NaN:
parseInt("Hello", 8); // Não é realmente um número parseInt("546", 2); // Dígitos não são válidos para representações binárias
Os seguintes exemplos sempre retornam -15:
-15
parseInt("-F", 16); parseInt("-0F", 16); parseInt("-0XF", 16); parseInt(-15.1, 10) parseInt(" -17", 8); parseInt(" -15", 10); parseInt("-1111", 2); parseInt("-15e1", 10); parseInt("-12", 13);
O seguinte exemplo retorna 224:
224
parseInt("0e0", 16);
Embora desencorajado pelo ECMAScript 3 e proibido pelo ECMAScript 5, muitas implementações interpretam uma string numérica começando com um 0 como octal. O exemplo abaixo pode ter um resultado octal, ou ele pode ter um resultado decimal. Sempre especifique uma base para evitar este comportamento não confiável.
0
parseInt("0e0"); // 0 parseInt("08"); // 0, '8' não é um dígito octal.
A especificação ECMAScript 5 da funcão parseInt não permite mais que as implementações tratem Strings começando com o caracter 0 como um valor octal. O ECMAScript 5 declara:
A função parseInt produz um valor inteiro ditado pela interpretação do conteúdo de uma argumento string de acordo com uma base específicada. Espaços em branco no início da string são ignorados. Se a base for undefined ou 0, ela é assumida como 10 exceto quando o número começa com os pares de caracter 0x or 0X, e neste caso a base 16 é assumida. Se a base é 16, o número pode também opcionalmente começar com os pares de caracter 0x or 0X.
0x
0X
16
Isto difere do ECMAScript 3, que desencoraja mas permite a interpretação octal.
Muitas implementações não adotaram este comportamento a partir de 2013, e porque browser antigos devem ser suportados, sempre especifique uma base.
É útil em algum momento ter uma maneira mais rigorosa para analisar valores inteiros. Expressões regulares podem ajudar:
filterInt = function (value) { if (/^(\-|\+)?([0-9]+|Infinity)$/.test(value)) return Number(value); return NaN; }; console.log(filterInt("421")); // 421 console.log(filterInt("-421")); // -421 console.log(filterInt("+421")); // 421 console.log(filterInt("Infinity")); // Infinity console.log(filterInt("421e+0")); // NaN console.log(filterInt("421hop")); // NaN console.log(filterInt("hop1.61803398875")); // NaN console.log(filterInt("1.61803398875")); // NaN
Enable JavaScript to view this browser compatibility table.
parseFloat()
Number.parseFloat()
Number.parseInt()
isNaN()
Number.toString()
Object.valueOf