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 o RangeError. É 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.23e+20).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 Status Comment
ECMAScript 3rd Edition (ECMA-262) Padrão Definição incial. Implementada no JavaScript 1.5.
ECMAScript 5.1 (ECMA-262)
The definition of 'Number.prototype.toFixed' in that specification.
Padrão  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Number.prototype.toFixed' in that specification.
Padrão  
ECMAScript Latest Draft (ECMA-262)
The definition of 'Number.prototype.toFixed' in that specification.
Rascunho  

Compatibilidade dos navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes1 Yes Yes Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes4 Yes Yes Yes

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: waveiro, akfzambrana
Última atualização por: waveiro,