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

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support YesEdge Full support YesFirefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

Veja também

Etiquetas do documento e colaboradores

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