CKTIS / Java
BigDecimal.valueOf — Dezimalwerte erzeugen
Lerne die drei Überladungen von `BigDecimal.valueOf` in Java 21 kennen und erfahre, warum die Umwandlung eines `double` vom Aufruf des Konstruktors abweichen kann.
Version: Java SE 21
Syntax
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 ist eine statische Fabrikmethode der Klasse java.math.BigDecimal. Mit import java.math.BigDecimal; kannst du sie über den Klassennamen ohne new aufrufen. In Java SE 21 gibt es drei Überladungen.
valueOf(long) übernimmt den ganzzahligen Wert mit der Skala 0. valueOf(long unscaledVal, int scale) liefert den exakten Wert unscaledVal × 10^(−scale) mit der angegebenen Skala. Beispielsweise ergibt BigDecimal.valueOf(1250L, 2) den Wert 12.50 mit der Skala 2. Die Skala darf negativ sein: BigDecimal.valueOf(125L, -2) hat den Zahlenwert 12500 und die Skala -2.
Für ein endliches double d liefert valueOf(double) dasselbe Ergebnis wie new BigDecimal(Double.toString(d)): Die Methode nutzt die kanonische Dezimaldarstellung von d als Text. new BigDecimal(d) stellt dagegen den exakt in d gespeicherten Binärwert dezimal dar. Daher liefert BigDecimal.valueOf(0.1) genau 0.1, während new BigDecimal(0.1) einen etwas größeren Wert liefert. Beide Varianten werfen bei NaN und bei positiver oder negativer Unendlichkeit eine NumberFormatException.
Die Umwandlung kann bereits verlorene Genauigkeit nicht wiederherstellen. Bei BigDecimal.valueOf(0.1 + 0.2) wird zuerst mit double addiert, daher lautet das Ergebnis 0.30000000000000004. Liegt der exakte Dezimalwert als Text vor, verwende new BigDecimal("0.1") statt des Umwegs über double. Es gibt keine Überladung BigDecimal.valueOf(String).
Beispiele
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());
}
}Ergebnis
0.1 0.1000000000000000055511151231257827021181583404541015625 125 12.50 0.30000000000000004
Die ersten beiden Zeilen vergleichen Fabrikmethode und Konstruktor für dasselbe `double`. Die dritte und vierte zeigen die ganzzahligen Überladungen, die letzte die Auswirkung der vorherigen Addition mit `double`. `toPlainString()` liefert die Textdarstellung des Werts ohne Exponentenschreibweise, und `println` gibt diesen Text aus.
Zugehörige Lektionen
- Java · Lektion 4 · Grundlagen · Version: 2
- Java · Lektion 6 · Grundlagen · Version: 2