CKTIS / Java
BigDecimal: presná desatinná aritmetika, mierka a porovnanie
Načítajte desatinné hodnoty bez prevodu cez `double`, počítajte presne, voľte mierku a pravidlo zaokrúhľovania a porovnávajte čísla bez ohľadu na mierku.
Verzia: Java SE 21
Syntax
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 konštruktor BigDecimal(String) z balíka java.math presne načíta desatinnú hodnotu bez prevodu cez double. Používajte desatinnú bodku, nie čiarku; biele znaky ani oddeľovače skupín číslic nie sú povolené. Neplatný text vyvolá NumberFormatException. Bez exponentu mierka udáva počet číslic za bodkou vrátane koncových núl; uvedený exponent sa od tejto mierky odpočíta.
Metódy BigDecimal.add a BigDecimal.multiply s jedným argumentom vracajú presný súčet a súčin. Súčet má väčšiu z mierok operandov; preferovanou mierkou súčinu je súčet ich mierok. Ak je tento súčet mimo rozsahu typu int, násobenie môže v JDK 21 vyvolať ArithmeticException. Ak má objekt, na ktorom sa metóda volá (this), nulovú hodnotu, metóda namiesto toho vráti nulu s mierkou nastavenou na najbližšiu hranicu rozsahu typu int. Preťažené varianty s MathContext môžu zaokrúhľovať podľa tohto kontextu. Objekty BigDecimal sú nemenné: uložte vrátený výsledok, pretože operandy sa nezmenia.
BigDecimal.setScale nastavuje mierku výsledku. setScale(int) vyvolá ArithmeticException, ak treba zaokrúhliť; setScale(int, RoundingMode) umožňuje zvoliť pravidlo. HALF_UP zaokrúhľuje na najbližšiu hodnotu, presne v polovici smerom od nuly. UNNECESSARY vyvolá ArithmeticException, ak treba zaokrúhliť. Preťažený variant setScale(int, int) je zastaraný.
BigDecimal.stripTrailingZeros odstráni koncové nuly zo zápisu bez zmeny hodnoty. Mierka sa môže stať zápornou, napríklad pri 600.0 po odstránení núl (mierka -2); pre nulu metóda vráti BigDecimal.ZERO. Pretečenie mierky vyvolá ArithmeticException. BigDecimal.toPlainString vráti text bez exponentu a bez formátovania podľa miestneho nastavenia. Ak chcete pevný počet desatinných miest, najprv nastavte mierku. Pri opätovnom načítaní textu sa zachová hodnota, ale nie nevyhnutne mierka.
BigDecimal.compareTo porovnáva čísla bez ohľadu na mierku: vráti -1, 0 alebo 1, ak je prvý operand menší ako druhý, rovný druhému alebo väčší ako druhý. Na číselnú rovnosť použite a.compareTo(b) == 0; equals vyžaduje rovnakú hodnotu aj mierku, preto pre 2.0 a 2.00 vráti false.
Prí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ýsledok
exact: 7.505 rounded: 7.51 stripped scale: -2 plain: 600 compareTo: 0 equals: false
Presný výsledok `7.505` sa zaokrúhli na `7.51`. Po odstránení núl z `600.0` je mierka `-2`, ale zápis bez exponentu je `600`. Porovnanie s `600.00` vráti `0`, zatiaľ čo `equals` vráti `false`.
Súvisiace lekcie
- Java · Lekcia 60 · Stredne pokročilá · Verzia: 2