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.