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

CKTIS / Java

RoundingMode — regras de arredondamento decimal

java.math.RoundingMode especifica uma regra de arredondamento utilizada, entre outras, por APIs como BigDecimal. HALF_UP escolhe o valor mais próximo e, em caso de empate, arredonda para longe de zero, também para números negativos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode é um tipo enumerado que especifica uma regra de arredondamento. RoundingMode.HALF_UP escolhe o valor mais próximo; em caso de empate, arredonda para longe de zero. Com escala 2, 2.345 passa a 2.35 e -2.345 passa a -2.35.

UP arredonda para longe de zero, DOWN na direção de zero, CEILING na direção do infinito positivo e FLOOR na direção do infinito negativo. HALF_DOWN e HALF_EVEN escolhem o valor mais próximo; em caso de empate, o primeiro arredonda na direção de zero e o segundo escolhe um resultado cuja última casa mantida seja par. UNNECESSARY exige um resultado exato; se for necessário arredondar, é lançada uma ArithmeticException.

Em BigDecimal, setScale(2, RoundingMode.HALF_UP) define duas casas decimais, não dois algarismos significativos. BigDecimal é imutável: utilize o valor devolvido. Um construtor que recebe uma cadeia de caracteres, como new BigDecimal("2.345"), preserva o valor decimal exato; um construtor que recebe um double pode introduzir efeitos da representação binária do número.

O exemplo compara HALF_UP com HALF_EVEN e mostra que o valor original não é alterado. A documentação abrange Java SE 21; o ambiente de produção não está atestado.

Exemplos

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal positive = new BigDecimal("2.345");
        BigDecimal negative = new BigDecimal("-2.345");

        System.out.println(positive.setScale(2, RoundingMode.HALF_UP));
        System.out.println(negative.setScale(2, RoundingMode.HALF_UP));
        System.out.println(positive.setScale(2, RoundingMode.HALF_EVEN));
        System.out.println(positive);
    }
}

Resultado

2.35
-2.35
2.34
2.345

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes