HOWTO · JavaScript

Arredondar um número para 2 casas decimais em JavaScript

Este tutorial ensina como arredondar um número para no máximo `2` casas decimais em JavaScript.

Nesta página

Use toFixed(2) quando precisar de um texto que sempre exiba dois dígitos após o separador decimal. O método retorna uma string, por isso os zeros finais continuam visíveis. Para obter um resultado numérico, use Math.round(value * 100) / 100 ou converta a string formatada com Number(). Essas abordagens são práticas para valores comuns, mas o JavaScript armazena números em ponto flutuante binário; por isso, valores decimais como 1.005 podem não ser arredondados como se espera.

Formate um número com toFixed()

Chame toFixed(2) em um número para obter uma string com duas casas decimais. Isso é útil em um rótulo, célula de tabela ou outro elemento visual no qual 5.60 deve manter o zero final. O valor retornado é texto; para fazer cálculos com ele, primeiro é preciso convertê-lo novamente em número.

Execute este exemplo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const value = 5.6789;
const fixedText = value.toFixed(2);
const roundedValue = Math.round(value * 100) / 100;
const numericValue = Number(value.toFixed(2));

function roundToTwo(number) {
  const shifted = Number(`${number}e2`);
  return Number(`${Math.round(shifted)}e-2`);
}

const shiftedValue = roundToTwo(value);
console.log(fixedText, roundedValue, numericValue, shiftedValue);
5.68 5.68 5.68 5.68

Na ordem, os valores são a string retornada por toFixed(), o número produzido por Math.round(), a conversão feita por Number() e o resultado do helper de deslocamento decimal. Apenas o primeiro valor é texto; convertê-lo com Number() produz um número e não preserva os zeros finais.

Arredonde um número com Math.round()

Multiplicar por 100 desloca a casa dos centésimos para a posição das unidades. Math.round() arredonda esse valor escalado para um inteiro, e dividir por 100 restaura a escala decimal. O resultado continua sendo um número, o que é conveniente para cálculos posteriores, mas não registra quantos dígitos decimais devem ser exibidos.

Math.round() resolve valores exatamente no meio arredondando em direção ao infinito positivo. Por exemplo, o empate em -1.5 é arredondado para -1; portanto, valores negativos não seguem uma regra que sempre arredonda para longe de zero. Além disso, a multiplicação também usa aritmética de ponto flutuante. Esse padrão é conciso, mas não garante arredondamento decimal exato para todas as entradas.

Entenda os casos-limite de ponto flutuante

O tipo Number do JavaScript representa valores usando ponto flutuante binário. Muitas frações decimais não podem ser representadas exatamente em binário, e operações intermediárias podem resultar em um valor ligeiramente abaixo ou acima do valor decimal pretendido. Um caso conhecido é 1.005: o valor armazenado fica um pouco abaixo da fração decimal, então 1.005.toFixed(2) pode produzir "1.00", e escalar o valor antes de usar Math.round() também pode levar a um resultado inesperado.

Number.EPSILON é a distância entre 1 e o próximo número representável. Somá-lo antes do arredondamento pode ajudar com algumas entradas próximas de 1, mas a distância entre números representáveis varia conforme a magnitude. Portanto, um ajuste fixo com epsilon não corrige todos os valores nem todos os históricos de operações.

toPrecision() controla os dígitos significativos, e não a quantidade de dígitos após o separador decimal. Por exemplo, Number((1.23456).toPrecision(4)).toFixed(2) produz "1.24", enquanto (1.23456).toFixed(2) produz "1.23": a primeira operação arredonda para 1.235, e a segunda arredonda esse valor intermediário novamente. Este é um caso específico de arredondamento duplo, não uma correção de uso geral; a primeira etapa de formatação pode descartar informações necessárias para a etapa seguinte.

Use um helper de deslocamento decimal

O helper acima desloca a escala decimal usando notação exponencial, arredonda o valor deslocado e depois desfaz o deslocamento. Isso pode evitar algumas surpresas causadas por multiplicar diretamente uma fração decimal por 100, mantendo o resultado como número. Para arredondar para outra quantidade de casas, ajuste o expoente: use essa quantidade no deslocamento inicial e seu valor negativo no deslocamento de retorno.

Considere esse helper uma opção prática para valores finitos comuns, não uma biblioteca de aritmética decimal. A representação de ponto flutuante continua se aplicando, e magnitudes extremas ou valores especiais podem exigir tratamento separado. Se o comportamento decimal exato for necessário para dinheiro ou contabilidade, use unidades monetárias inteiras quando o domínio permitir ou uma biblioteca de aritmética decimal com regras escolhidas para a aplicação. Formatar um resultado para exibição e fazer cálculos decimais exatos são requisitos diferentes.

Escolha a abordagem adequada

Escolha toFixed(2) quando precisar de texto de largura fixa para exibição: ele mantém os zeros finais e retorna uma string. Escolha Math.round(value * 100) / 100 quando um resultado numérico compacto for útil e o intervalo de entrada for adequado à aritmética comum de ponto flutuante. Escolha Number(value.toFixed(2)) quando quiser aplicar o comportamento de arredondamento de toFixed() e depois obter um valor numérico, lembrando que números não preservam formatação de exibição. O helper de deslocamento decimal também pode ser usado como opção numérica, desde que suas limitações sejam consideradas.

Nenhum desses métodos torna os números do JavaScript quantidades decimais exatas. Em interfaces, formate o valor no momento da exibição. Para cálculos com regras decimais estritas, defina explicitamente a política de arredondamento e a representação numérica, e então teste valores representativos do domínio da aplicação.