Number.prototype.toFixed()
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.
O método toFixed()
formata um número utilizando notação de ponto fixo.
Sintaxe
numObj.toFixed([dígitos])
Parâmetros
dígitos
-
Opcional. O número de dígitos que aparecem depois do ponto decimal; este pode ser um valor entre 0 e 20, inclusive, e algumas implementacões podem suportar uma variação de números maiores. Se este argumento for omitido, será tratado como 0.
Retorno
Uma string representando o número usando notação em ponto fixo.
Throws
RangeError
-
Se
dígitos
for muito pequeno ou muito grande. Valores entre 0 e 20, inclusive, não irão causar oRangeError
. É permitido às implementações suportar valores maiores e menores. TypeError
-
Se este método for chamado em um objeto que não é
Number
.
Descrição
Uma string representando numObj
que não usa notação exponencial e tem exatamente dígitos
dígitos depois da casa decimal. O número será arredondado se necessário, e será adicionado zeros a parte após a virgula para que este tenha o tamanho que foi especificado. Se o numObj
for maior que 1e+21
, entao será invocado o método Number.prototype.toString()
e será retornado uma string em notação exponencial.
Exemplos
Utilizando toFixed
var numObj = 12345.6789;
numObj.toFixed(); // Retorna '12346': note o arredondamento, não possui nenhuma parte fracionária
numObj.toFixed(1); // Retorna '12345.7': note o arredondamento
numObj.toFixed(6); // Retorna '12345.678900': note que adicionou zeros
(1.23e20).toFixed(2); // Retorna '123000000000000000000.00'
(1.23e-10).toFixed(2); // Retorna '0.00'
(2.34).toFixed(1); // Retorna '2.3'
(2.35).toFixed(1); // Retorna '2.4'. Note que arredonda para cima neste caso.
-(2.34).toFixed(1); // Retorna -2.3 (devido à precedência do operador, literais de números negativos não retornam uma string...)
(-2.34).toFixed(1); // Retorna '-2.3' (...a menos que se utilize parênteses)
Especificações
Specification |
---|
ECMAScript Language Specification # sec-number.prototype.tofixed |
Compatibilidade com navegadores
BCD tables only load in the browser