CKTIS / Java
BigDecimal: přesná desetinná aritmetika, měřítko a porovnání
Načítejte desetinné hodnoty bez převodu přes `double`, počítejte přesně, nastavujte měřítko a pravidlo zaokrouhlování a porovnávejte čísla bez ohledu na měřítko.
Verze: Java SE 21
Syntaxe
java.math.BigDecimal — Java SE 21
BigDecimal(String val)
BigDecimal add(BigDecimal augend)
BigDecimal multiply(BigDecimal multiplicand)
BigDecimal setScale(int newScale)
BigDecimal setScale(int newScale, RoundingMode roundingMode)
BigDecimal stripTrailingZeros()
int compareTo(BigDecimal val)
String toPlainString()
RoundingMode: java.math.RoundingModeV Java SE 21 konstruktor BigDecimal(String) z balíčku java.math přesně načte desetinnou hodnotu bez převodu přes double. Použijte desetinnou tečku, nikoli čárku; bílé znaky ani oddělovače skupin číslic nejsou povoleny. Neplatný text vyvolá NumberFormatException. Bez exponentu měřítko udává počet číslic za tečkou včetně koncových nul; uvedený exponent se od tohoto měřítka odečítá.
Metody BigDecimal.add a BigDecimal.multiply s jedním argumentem vracejí přesný součet a součin. Součet má větší z měřítek operandů; upřednostňovaným měřítkem součinu je součet jejich měřítek. Pokud je tento součet mimo rozsah typu int, může násobení v JDK 21 vyvolat ArithmeticException. Má-li objekt, na kterém se metoda volá (this), nulovou hodnotu, metoda místo toho vrátí nulu s měřítkem nastaveným na nejbližší mez rozsahu typu int. Přetížené varianty s MathContext mohou zaokrouhlovat podle tohoto kontextu. Objekty BigDecimal jsou neměnné: uložte vrácený výsledek, protože operandy se nezmění.
BigDecimal.setScale nastavuje měřítko výsledku. setScale(int) vyvolá ArithmeticException, pokud je potřeba zaokrouhlit; setScale(int, RoundingMode) umožňuje zvolit pravidlo. HALF_UP zaokrouhluje na nejbližší hodnotu, přesně v polovině směrem od nuly. UNNECESSARY vyvolá ArithmeticException, pokud je potřeba zaokrouhlit. Varianta setScale(int, int) je zastaralá.
BigDecimal.stripTrailingZeros odstraní koncové nuly ze zápisu, aniž změní hodnotu. Měřítko může být záporné, jako u 600.0 po odstranění nul (měřítko -2); pro nulu metoda vrací BigDecimal.ZERO. Přetečení měřítka vyvolá ArithmeticException. BigDecimal.toPlainString vrací text bez exponentu a bez formátování podle místního nastavení. Pro pevný počet desetinných míst nejprve nastavte měřítko. Při opětovném načtení textu se zachová hodnota, ale ne nutně měřítko.
BigDecimal.compareTo porovnává čísla bez ohledu na měřítko: vrací -1, 0 nebo 1, pokud je první operand menší než druhý, rovný druhému nebo větší než druhý. Pro číselnou rovnost použijte a.compareTo(b) == 0; equals vyžaduje stejnou hodnotu i měřítko, a proto pro 2.0 a 2.00 vrací false.
Příklady
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal unitPrice = new BigDecimal("2.500");
BigDecimal quantity = new BigDecimal("3");
BigDecimal fee = new BigDecimal("0.005");
BigDecimal exact = unitPrice.multiply(quantity).add(fee);
BigDecimal rounded = exact.setScale(2, RoundingMode.HALF_UP);
BigDecimal stripped = new BigDecimal("600.0").stripTrailingZeros();
BigDecimal sameValue = new BigDecimal("600.00");
System.out.println("exact: " + exact.toPlainString());
System.out.println("rounded: " + rounded.toPlainString());
System.out.println("stripped scale: " + stripped.scale());
System.out.println("plain: " + stripped.toPlainString());
System.out.println("compareTo: " + stripped.compareTo(sameValue));
System.out.println("equals: " + stripped.equals(sameValue));
}
}Výsledek
exact: 7.505 rounded: 7.51 stripped scale: -2 plain: 600 compareTo: 0 equals: false
Přesný výsledek `7.505` se zaokrouhlí na `7.51`. Po odstranění nul z `600.0` je měřítko `-2`, ale zápis bez exponentu je `600`. Porovnání s `600.00` vrátí `0`, zatímco `equals` vrátí `false`.
Související lekce
- Java · Lekce 60 · Středně pokročilá · Verze: 2