CKTIS / Java
RoundingMode — reglas de redondeo decimal
java.math.RoundingMode especifica una regla de redondeo que utilizan, entre otras, las API como BigDecimal. HALF_UP elige el valor más cercano y, en caso de empate, redondea alejándose de cero, también con números negativos.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
value.setScale(newScale, RoundingMode.HALF_UP)java.math.RoundingMode es un tipo enumerado que especifica una regla de redondeo. RoundingMode.HALF_UP elige el valor más cercano; en caso de empate, redondea alejándose de cero. Con escala 2, 2.345 se convierte en 2.35 y -2.345 en -2.35.
UP redondea alejándose de cero, DOWN hacia cero, CEILING hacia el infinito positivo y FLOOR hacia el infinito negativo. HALF_DOWN y HALF_EVEN eligen el valor más cercano; en caso de empate, el primero redondea hacia cero y el segundo elige un resultado cuya última cifra conservada sea par. UNNECESSARY exige un resultado exacto; si hace falta redondear, se produce una ArithmeticException.
En BigDecimal, setScale(2, RoundingMode.HALF_UP) establece dos cifras decimales, no dos cifras significativas. BigDecimal es inmutable: hay que usar el valor devuelto. Un constructor que recibe una cadena, como new BigDecimal("2.345"), conserva el valor decimal exacto; uno que recibe un double puede introducir efectos de la representación binaria del número.
El ejemplo compara HALF_UP con HALF_EVEN y muestra que el valor original no cambia. La documentación corresponde a Java SE 21; el entorno de producción no está acreditado.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.