CKTIS / Java
BigDecimal.valueOf — creare valori decimali
Scopri i tre overload di `BigDecimal.valueOf` in Java 21 e perché convertire un `double` con questo metodo può dare un risultato diverso dal costruttore.
Versione: Java SE 21
Sintassi
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 è un metodo factory statico della classe java.math.BigDecimal. Dopo aver aggiunto import java.math.BigDecimal;, puoi chiamarlo sul nome della classe senza new. In Java SE 21 sono disponibili tre overload.
valueOf(long) mantiene il valore intero e imposta la scala a 0. valueOf(long unscaledVal, int scale) restituisce il valore esatto unscaledVal × 10^(−scale) con la scala specificata. Per esempio, BigDecimal.valueOf(1250L, 2) dà 12.50 con scala 2. La scala può essere negativa: BigDecimal.valueOf(125L, -2) ha valore numerico 12500 e scala -2.
Per un double d finito, valueOf(double) dà lo stesso risultato di new BigDecimal(Double.toString(d)): usa la rappresentazione decimale canonica di d come testo. Invece, new BigDecimal(d) rappresenta in decimale l’esatto valore binario memorizzato in d. Perciò BigDecimal.valueOf(0.1) dà esattamente 0.1, mentre new BigDecimal(0.1) dà un valore leggermente maggiore. Entrambe le forme lanciano NumberFormatException per NaN e per entrambi gli infiniti.
La conversione non può recuperare la precisione già persa. In BigDecimal.valueOf(0.1 + 0.2) la somma avviene prima in double, quindi il risultato è 0.30000000000000004. Se parti da un testo decimale esatto, usa new BigDecimal("0.1") senza passare per double. Non esiste un overload BigDecimal.valueOf(String).
Esempi
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());
}
}Risultato
0.1 0.1000000000000000055511151231257827021181583404541015625 125 12.50 0.30000000000000004
Le prime due righe confrontano il metodo factory e il costruttore per lo stesso `double`. La terza e la quarta mostrano gli overload con argomenti interi, mentre l’ultima mostra l’effetto di una somma precedente in `double`. `toPlainString()` restituisce la rappresentazione testuale del valore senza notazione esponenziale e `println` stampa quel testo.
Lezioni correlate
- Java · Lezione 4 · Base · Versione: 2
- Java · Lezione 6 · Base · Versione: 2