CKTIS / Java
BigDecimal: točno decimalno računanje, skala i usporedba
Učitaj decimalne vrijednosti bez pretvorbe preko `double`, računaj točno, odaberi skalu i pravilo zaokruživanja te uspoređuj brojeve neovisno o skali.
Verzija: Java SE 21
Sintaksa
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.RoundingModeU Java SE 21 konstruktor BigDecimal(String) iz paketa java.math točno učitava decimalnu vrijednost bez pretvorbe preko double. Upotrijebi decimalnu točku, a ne zarez; bjeline i razdjelnici skupina znamenaka nisu dopušteni. Nevaljan zapis izaziva NumberFormatException. Bez eksponenta skala je broj znamenaka iza točke, uključujući završne nule; navedeni se eksponent oduzima od te skale.
Metode s jednim argumentom BigDecimal.add i BigDecimal.multiply vraćaju točan zbroj odnosno umnožak. Skala zbroja je veća od dviju skala operanada ili jednaka objema ako su iste; preferirana skala umnoška je zbroj skala operanada. U JDK-u 21 množenje može izazvati ArithmeticException ako je taj zbroj izvan raspona tipa int. Ako objekt na kojem se metoda poziva (this) ima vrijednost nula, metoda umjesto toga vraća nulu sa skalom postavljenom na najbližu granicu tog raspona. Preopterećene inačice s MathContext mogu zaokružiti prema tom kontekstu. Objekti BigDecimal nepromjenjivi su: spremi vraćeni rezultat jer se operandi ne mijenjaju.
BigDecimal.setScale postavlja skalu rezultata. setScale(int) izaziva ArithmeticException ako je potrebno zaokruživanje; setScale(int, RoundingMode) omogućuje odabir pravila. HALF_UP zaokružuje na najbližu vrijednost, a na pola puta od nule. UNNECESSARY izaziva ArithmeticException ako je potrebno zaokruživanje. Preopterećena inačica setScale(int, int) zastarjela je.
BigDecimal.stripTrailingZeros uklanja završne nule iz zapisa bez promjene vrijednosti. Skala može postati negativna, kao kod 600.0 nakon uklanjanja nula (skala -2); za nulu metoda vraća BigDecimal.ZERO. Prekoračenje raspona skale izaziva ArithmeticException. BigDecimal.toPlainString vraća tekst bez eksponenta i bez oblikovanja prema regionalnim postavkama. Za fiksan broj decimalnih mjesta prvo postavi skalu. Ponovno učitavanje teksta čuva vrijednost, ali ne nužno i skalu.
BigDecimal.compareTo uspoređuje brojeve neovisno o skali: vraća -1, 0 ili 1 kada je prvi operand manji od drugog, jednak drugom ili veći od drugog. Za brojčanu jednakost upotrijebi a.compareTo(b) == 0; equals zahtijeva istu vrijednost i istu skalu pa za 2.0 i 2.00 vraća false.
Primjeri
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));
}
}Rezultat
exact: 7.505 rounded: 7.51 stripped scale: -2 plain: 600 compareTo: 0 equals: false
Točan rezultat `7.505` zaokružuje se na `7.51`. Nakon uklanjanja nula iz `600.0` skala je `-2`, ali zapis bez eksponenta glasi `600`. Usporedba s `600.00` daje `0`, dok `equals` vraća `false`.
Povezane lekcije
- Java · Lekcija 60 · Srednje · Verzija: 2