Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.prototype.toPrecision: algarismos significativos

toPrecision devolve texto com a quantidade pedida de algarismos significativos, escolhendo notação fixa ou exponencial.

Versão: ECMAScript 3 onward; example target: Node.js 24.22.2

Sintaxe

number.toPrecision(precision)

number.toPrecision(precision) formata o valor com precision algarismos significativos. Se o argumento for omitido ou undefined, o método devolve imediatamente o resultado ToString normal do número. Um argumento fornecido passa por ToIntegerOrInfinity: a parte fracionária é truncada em direção a zero e NaN torna-se 0; para um recetor finito, um resultado fora de 1..100 lança RangeError.

Depois de converter um argumento fornecido, um recetor NaN ou ±Infinity devolve o texto normal antes da verificação do intervalo, por isso Infinity.toPrecision(0) dá "Infinity". Um objeto passado como precision pode, contudo, lançar durante a conversão. Para um valor finito usa notação exponencial quando o expoente decimal é menor que -6 ou pelo menos precision; caso contrário usa notação fixa. Arredonda para o resultado mais próximo e, num empate após separar o sinal, para a maior magnitude.

O método existe desde ECMAScript 3, não é genérico e lança TypeError se o recetor não for Number nem Number encapsulado. Devolve texto, não um número. Number usa representação binária, pelo que o arredondamento pode surpreender; usa Intl.NumberFormat para apresentação local.

Exemplos

console.log((1234.5).toPrecision(4), (1234.5).toPrecision(3));
console.log((0.0000012345).toPrecision(3), (0.00000012345).toPrecision(3));
console.log((7).toPrecision(), (-0).toPrecision(3));
console.log(Infinity.toPrecision(0));
try { console.log((1).toPrecision(0)); } catch (error) { console.log(error.name); }
try { Number.prototype.toPrecision.call("1", 2); } catch (error) { console.log(error.name); }

Resultado

1235 1.23e+3
0.00000123 1.23e-7
7 0.00
Infinity
RangeError
TypeError

O exemplo compara notação fixa e exponencial e mostra -0, Infinity e erros de intervalo/recetor.

Fontes