Método toPrecision() do Number do JavaScript

Definição e uso

toPrecision() O método formata o número com o comprimento especificado.

Este método formata o número de dígitos significativos.

Exemplo

Exemplo 1

Formata o número com a comprimento especificado:

let num = 13.3714;
let n = num.toPrecision(2);

Experimente você mesmo

Exemplo 2

Formatação de decimal:

let num = 0.001658853;
num.toPrecision(2);
num.toPrecision(3);
num.toPrecision(10);

Experimente você mesmo

Exemplo 3

Formata o número com a comprimento especificado:

let num = 13.3714;
num.toPrecision(2);
num.toPrecision(3);
num.toPrecision(10);

Experimente você mesmo

Exemplo 4

Sem formato:

let num = 13.3714;
num.toPrecision();

Experimente você mesmo

sintaxe

number.toPrecision(precision)

parâmetro

parâmetro Descrição
precision

Opcional. Número de dígitos.

Valores entre 1 e 21 (inclusive 1 e 21).

Se omitido, retorna o número sem qualquer formato.

Retorna o valor

tipo Descrição
string formata o número com a precisão especificada.

detalhes técnicos

Retorna o valor

Retorna a representação de string do Number, contendo precision dígitos significativos.

Se precision suficientemente grande para incluir todos os dígitos da parte inteira do Number, então a string retornada usará a contagem fixa.

Caso contrário, usa-se a contagem exponencial, ou seja, um dígito antes do ponto decimal e precision1 dígito negativo.

Se necessário, o número será arredondado ou preenchido com 0.

lança

exceção Descrição
RangeError

Quando precision Lança exceção quando muito pequeno ou muito grande.

Valores entre 1 e 21 não causam essa exceção.

Algumas implementações suportam um intervalo maior ou menor de valores.
TypeError Lança uma exceção se o objeto chamado não for Number.

Suporte do navegador

toPrecision() É uma característica do ECMAScript3 (ES3).

Todos os navegadores suportam completamente o ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte