Number.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Resumo

O método toString() retorna uma string representando o objeto Number especificado.

Sintaxe

numObj.toString([radix])

Parâmetros

radix

Opcional. Um inteiro entre 2 e 36 especificando a base utilizada para representar os valores numéricos.

Exceções

RangeError

se toString() receber um valor de radix fora do intervalo entre 2 e 36, uma exceção RangeError é lançada.

Descrição

O objeto Number sobrescreve o método toString() do objeto Object; ele não herda de Object.prototype.toString(). Para objetos Number, o método toString() retorna uma representação string do objeto na base especificada.

O método toString() analisa seu primeiro argumento e tenta retornar uma representação string na raiz (base) especificada. Para raizes maiores que 10, as letras do alfabeto indicam valores maiores que 9. Por exemplo, para números hexadecimais (base 16), letras entre a e f são utilizadas.

Se o radix não for especificado, a raiz assumida como preferencial é a 10.

Se o numObj for negativo, o sinal é preservado. Isto acontece mesmo se a raiz for 2; a string retornada é a representação binária positiva de numObj precedida por um sinal - e não o complemento de dois do numObj.

Exemplos

Exemplo: Usando toString

js
var count = 10;

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

var x = 6;

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

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

Especificações

Specification
ECMAScript® 2025 Language Specification
# sec-number.prototype.tostring

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também