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

CKTIS / JavaScript

Number.prototype.toFixed: casas decimais fixas

toFixed devolve texto de ponto fixo com exatamente a quantidade pedida de dígitos após o ponto.

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

Sintaxe

number.toFixed(fractionDigits)

number.toFixed(fractionDigits) devolve texto com exatamente fractionDigits dígitos após o ponto; omitir o argumento significa 0. O argumento passa por ToIntegerOrInfinity: uma fração é truncada em direção a zero, NaN torna-se 0 e -0.5 também conduz a zero. O intervalo 0..100 é verificado antes dos valores não finitos, por isso até Infinity.toFixed(101) lança RangeError.

Com uma quantidade válida, NaN e ±Infinity devolvem "NaN" e o texto de infinito correspondente. Se o valor absoluto for pelo menos 10**21, o método usa ToString normal e não acrescenta casas fixas. Caso contrário escolhe o resultado mais próximo e, num empate após separar o sinal, a maior magnitude. Como Number é binário, (2.55).toFixed(1) dá "2.5"; o zero negativo perde o sinal, mas um valor negativo pequeno arredondado a zero pode dar "-0.00".

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, sem formatação local. Para dinheiro, toFixed não elimina o erro binário; guarda a unidade mínima como inteiro ou usa um tipo decimal adequado.

Exemplos

console.log((12.375).toFixed(2), (2.55).toFixed(1));
console.log((-0).toFixed(2), (-0.0001).toFixed(2));
console.log((1e21).toFixed(2), Infinity.toFixed(2));
try { console.log(Infinity.toFixed(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toFixed.call("1", 2); } catch (error) { console.log(error.name); }

Resultado

12.38 2.5
0.00 -0.00
1e+21 Infinity
RangeError
TypeError

O exemplo mostra arredondamento, surpresa binária, -0, limite 10**21 e RangeError com Infinity.

Fontes