Artigo original: JavaScript Number to String – How to Use toString to Convert an Int into a String

O método toString() é um método interno do objeto Number do JavaScript que permite converter qualquer valor de tipo number em sua representação de tipo string.

Como usar o método toString em JavaScript

Para usar o método toString(), você simplesmente precisa chamar o método em um valor do tipo number. O exemplo a seguir mostra como converter o valor numérico 24 em sua representação no formato string. Observe como o valor da variável str é colocado entre aspas duplas:

var num = 24;
var str = num.toString();

console.log(num); // 24
console.log(str); // "24"
Convertendo um número em uma string com o método toString()

Você também pode chamar o método toString() imediatamente em um valor do tipo number, mas precisa adicionar parênteses () para encapsular o valor – do contrário, o JavaScript responderá com um erro do tipo Invalid or unexpected token (token inválido ou inesperado, em português).

O método toString() também pode converter números de ponto flutuante e negativos, como vemos abaixo:

24.toString(); // Error: Invalid or unexpected token
(24).toString(); // "24"
(9.7).toString(); // "9.7"
(-20).toString(); // "-20"
Convertendo qualquer tipo de número usando o método toString()

Por fim, o método toString() também aceita os parâmetros radix ou base. radix permite que você converta um número do sistema decimal (de base 10) em uma string que represente o número em qualquer outro sistema numérico.

Os sistemas numéricos válidos para a conversão são:

  • Sistema binário (de base 2), que têm dois algarismos – 0 e 1
  • Sistema ternário (de base 3), que têm três algarismos – 0, 1 e 2
  • Sistema quaternário (de base 4), que têm quatro algarismos – 0, 1, 2 e 3
  • E assim por diante até o sistema Hexatridecimal (de base 36), que tem a combinação dos números arábicos (de 0 a 9) com as letras latinas de A até Z
Number.toString(radix);
A sintaxe para o método toString(), aceitando um parâmetro radix

Os parâmetros radix aceitam dados do tipo number com valores que vão de 2 a 36. Aqui temos um exemplo da conversão de um número decimal, 5, em sua representação no sistema binário (de base 2):

var str = (5).toString(2);

console.log(str); // "101"
Conversão do número decimal em um número binário com o método toString()

O número decimal 5 do código acima é convertido em seu equivalente no sistema binário, 101, e convertido em uma string.

Como usar outros tipos de dados com o método toString()

Além de converter dados do tipo number, o método toString() também pode converter outros tipos de dados em suas representações em strings.

Por exemplo, é possível converter um tipo array em sua representação em string da seguinte maneira:

var arr = [ "Nathan", "Jack" ];
var str = arr.toString();

console.log(str); // "Nathan,Jack"
Convertendo um array em string com o método toString()

Também é possível converter um tipo boolean em string, como vemos abaixo:

var bool = true;
var str = bool.toString();

console.log(str); // "true"

Creio, porém, que o mais frequente seja usar o método toString() para converter um dado do tipo number, no lugar de dados de outros tipos, em uma string. É o que eu, em geral, normalmente faço, também. 🙂

Agradecemos por você ter lido este tutorial

Você também pode se interessar em outros tutoriais de JavaScript que o autor escreveu, incluindo Rounding Numbers with toFixed() Method e Calculating Absolute Value with Math.abs() ("Arredondar números com o método toFixed()" e "Calcular o valor absoluto com Math.Abs()", respectivamente – textos em inglês). Eles são dois dos problemas que mais frequentemente causam dúvidas em JavaScript.

O autor também tem uma newsletter gratuita sobre tutoriais de desenvolvimento para a web (em grande parte, com textos relacionados ao JavaScript).