CKTIS / Java
BigDecimal.valueOf — crear valores decimales
Conoce las tres sobrecargas de `BigDecimal.valueOf` en Java 21 y por qué convertir un `double` con este método puede dar un resultado distinto al del constructor.
Versión: Java SE 21
Sintaxis
import java.math.BigDecimal;
// Static overloads declared by java.math.BigDecimal:
public static BigDecimal valueOf(long val)
public static BigDecimal valueOf(long unscaledVal, int scale)
public static BigDecimal valueOf(double val)BigDecimal.valueOf es un método de fábrica estático de la clase java.math.BigDecimal. Tras añadir import java.math.BigDecimal;, se invoca con el nombre de la clase, sin new. Java SE 21 ofrece tres sobrecargas.
valueOf(long) conserva el valor entero y establece la escala en 0. valueOf(long unscaledVal, int scale) devuelve el valor exacto unscaledVal × 10^(−scale) con la escala indicada. Por ejemplo, BigDecimal.valueOf(1250L, 2) da 12.50 con escala 2. La escala puede ser negativa: BigDecimal.valueOf(125L, -2) tiene el valor numérico 12500 y escala -2.
Para un double d finito, valueOf(double) da el mismo resultado que new BigDecimal(Double.toString(d)): usa la representación decimal canónica de d en forma de texto. En cambio, new BigDecimal(d) representa en decimal el valor binario exacto almacenado en d. Por eso BigDecimal.valueOf(0.1) da exactamente 0.1, mientras que new BigDecimal(0.1) da un valor algo mayor. Ambas formas lanzan NumberFormatException para NaN y para ambos infinitos.
La conversión no recupera la precisión que ya se ha perdido. En BigDecimal.valueOf(0.1 + 0.2), la suma se realiza primero en double, por lo que el resultado es 0.30000000000000004. Si partes de un texto decimal exacto, usa new BigDecimal("0.1") en lugar de pasar por double. No existe la sobrecarga BigDecimal.valueOf(String).
Ejemplos
import java.math.BigDecimal;
public class Main {
public static void main(String[] args) {
double input = 0.1;
System.out.println(BigDecimal.valueOf(input).toPlainString());
System.out.println(new BigDecimal(input).toPlainString());
System.out.println(BigDecimal.valueOf(125L).toPlainString());
System.out.println(BigDecimal.valueOf(1250L, 2).toPlainString());
System.out.println(BigDecimal.valueOf(0.1 + 0.2).toPlainString());
}
}Resultado
0.1 0.1000000000000000055511151231257827021181583404541015625 125 12.50 0.30000000000000004
Las dos primeras líneas comparan el método de fábrica y el constructor para el mismo `double`. La tercera y la cuarta muestran las sobrecargas con enteros, y la última muestra el efecto de una suma previa en `double`. `toPlainString()` devuelve la representación textual del valor sin notación exponencial, y `println` imprime ese texto.
Lecciones relacionadas
- Java · Lección 4 · Básico · Versión: 2
- Java · Lección 6 · Básico · Versión: 2