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.