CKTIS / Java
BigDecimal.setScale — cambiar la escala y redondear
Ajusta la escala de un `BigDecimal` sin cambiar su valor o elige explícitamente cómo redondearlo. La llamada no modifica el objeto original.
Versión: Java SE 21
Sintaxis
public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)BigDecimal.setScale es un método de instancia de java.math.BigDecimal. Una escala no negativa indica el número de posiciones decimales; una escala de -1 representa múltiplos de diez. La escala no es la precisión (el número de dígitos del valor no escalado). El método devuelve un BigDecimal, no texto formateado. El objeto original es inmutable: usa el valor devuelto, que no tiene por qué ser un objeto nuevo.
setScale(int) conserva el valor numérico. En notación decimal, aumentar la escala puede añadir ceros al final, y una reducción exacta solo puede quitar ceros. Si hace falta redondear, el método lanza ArithmeticException.
setScale(int, RoundingMode) aplica el modo elegido de java.math.RoundingMode si reducir la escala requiere redondeo. HALF_UP elige el valor más cercano en la escala solicitada y, en caso de empate, el más alejado de cero: 2.675 pasa a 2.68 con escala 2. UNNECESSARY exige un resultado exacto y provoca una ArithmeticException si hace falta redondear.
La sobrecarga setScale(int, int) está obsoleta desde Java 9 y lanza IllegalArgumentException si el segundo argumento no representa un modo de redondeo válido. En código nuevo, usa la sobrecarga con RoundingMode. Para introducir un decimal exacto, usa new BigDecimal("2.675") en lugar de new BigDecimal(2.675), que incorpora la aproximación binaria del double.
Ejemplos
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal original = new BigDecimal("2.675");
BigDecimal padded = original.setScale(4);
System.out.println(padded.toPlainString());
System.out.println(padded.setScale(3).toPlainString());
System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());
try {
original.setScale(2);
} catch (ArithmeticException e) {
System.out.println("ArithmeticException");
}
System.out.println(original.toPlainString());
}
}Resultado
2.6750 2.675 2.68 ArithmeticException 2.675
Las dos primeras líneas muestran cómo se añade y se quita un cero final sin cambiar el valor. La tercera muestra el redondeo, la cuarta informa de la excepción capturada y la última muestra el original sin cambios.
Lecciones relacionadas
- Java · Lección 4 · Básico · Versión: 2
- Java · Lección 6 · Básico · Versión: 2
- Java · Lección 69 · Básico · Versión: 2