O método toString() retorna  uma string com o valor do objecto Number especificado.

Sintaxe

numObj.toString([radix])

Parâmetros

base
Opcional. Um inteiro entre [2, 36] especificando a base usada para representar o valor númerico.

Erros possíveis

RangeError
Se o valor do parâmetro base não estiver entre [2, 36], o erro RangeError é lançado.

Descrição

O objecto Number faz override ao método toString() do objecto Object; não herda de Object.prototype.toString(). Para os objectos Number, o método toString() retorna uma representação em string do ojecto na base especificada.

O método toString() analisa o seu primeiro argumento e tenta retornar uma representação em string na base especificada. Para bases superiores a 10, as letras do alfabeto representam numerais maiores do que 9 (por ordem alfabética: a, b, c ...). Por exemplo, para números hexadecimais (base 16) são usadasa as letras do alfabeto até f.

Se a base não for especificada, o seu valor assumido é 10.

Se o numObj tem um valor negativo (< 0), o sinal é preservado. O mesmo se aplica se a base tiver o valor 2; a string retornada é a representação positiva do binário de numObj precedida pelo sinal negativo (-), e não complement para 2 de numObj.

Exemplos

Usando toString

var count = 10;

console.log(count.toString());    // imprime '10'
console.log((17).toString());     // imprime '17'

var x = 6;

console.log(x.toString(2));       // imprime '110'
console.log((254).toString(16));  // imprime 'fe'

console.log((-10).toString(2));   // imprime '-1010'
console.log((-0xff).toString(2)); // imprime'-11111111'

Especificações

Specification Status Comment
ECMAScript 1st Edition (ECMA-262) Standard Definição inicial. Implementado em JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'Number.prototype.tostring' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Number.prototype.tostring' in that specification.
Standard  

Compatibilidade dos browsers

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Funcionalidade Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes)
Funcionalidade Android Chrome para Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
BSuporte básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Ver também

Etiquetas do documento e contribuidores

Contribuidores para esta página: Redeagle48
Última atualização por: Redeagle48,