CKTIS / Java
BigDecimal — desiatková aritmetika a zaokrúhľovanie
java.math.BigDecimal podporuje desiatkové čísla s ľubovoľnou presnosťou, ktoré sa hodia okrem iného na peňažné výpočty. Zoznámte sa s vytváraním hodnôt, operáciami, mierkou, porovnávaním a explicitným zaokrúhľovaním.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
new BigDecimal("12.50"); BigDecimal.valueOf(3); a.add(b); a.subtract(b); a.multiply(b); a.divide(b, 2, RoundingMode.HALF_EVEN); a.setScale(2, RoundingMode.HALF_EVEN); a.compareTo(BigDecimal.ZERO); a.stripTrailingZeros().toPlainString();java.math.BigDecimal je nemenné desiatkové číslo s ľubovoľnou presnosťou. BigDecimal(String) vytvorí presnú hodnotu z textu; BigDecimal.valueOf(long) ju vytvorí z celého čísla. BigDecimal.valueOf(double) používa textovú reprezentáciu typu double, ale nedokáže napraviť skoršie chyby výpočtu. Ak chcete presne hodnotu 0.1, vyhnite sa new BigDecimal(0.1).
BigDecimal.add, BigDecimal.subtract a BigDecimal.multiply vykonávajú sčítanie, odčítanie a násobenie; ďalej používajte vrátený výsledok. BigDecimal.ZERO je nula s mierkou 0. BigDecimal.compareTo porovnáva číselné hodnoty a ignoruje rozdiely v mierke; equals mierku zohľadňuje, preto považuje 2.0 a 2.00 za rozdielne.
BigDecimal.divide bez parametrov zaokrúhľovania vyžaduje presný konečný desiatkový rozvoj. Volanie BigDecimal.ONE.divide(BigDecimal.valueOf(3)) vyvolá ArithmeticException, pretože presný podiel nemá konečný desiatkový rozvoj. Výraz 1 / 3 v Jave naopak vykoná celočíselné delenie a jeho výsledkom je 0. Delenie nulou vyvolá túto výnimku tiež. Ak je zaokrúhlenie prijateľné, zadajte mierku a RoundingMode. HALF_EVEN vyberá najbližšiu hodnotu a pri rovnakej vzdialenosti tú, ktorej posledná zachovaná číslica je párna.
BigDecimal.setScale nastavuje mierku, nie počet platných číslic; zníženie mierky môže vyžadovať zaokrúhlenie. Pri nezáporných mierkach ide o počet desatinných miest. BigDecimal.stripTrailingZeros odstráni koncové nuly bez zmeny hodnoty a môže viesť k zápornej mierke. BigDecimal.toPlainString zobrazí výsledok bez exponentu; nejde o formátovanie meny závislé od miestnych nastavení.
Príklady
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal price = new BigDecimal("12.50");
BigDecimal total = price.multiply(BigDecimal.valueOf(3))
.add(new BigDecimal("2.00"))
.subtract(new BigDecimal("1.00"))
.setScale(2, RoundingMode.HALF_EVEN);
BigDecimal share = total.divide(BigDecimal.valueOf(3), 2,
RoundingMode.HALF_EVEN);
System.out.println(total.toPlainString());
System.out.println(share.toPlainString());
System.out.println(total.compareTo(BigDecimal.ZERO) > 0);
System.out.println(new BigDecimal("12.500")
.stripTrailingZeros().toPlainString());
}
}Výsledok
38.50 12.83 true 12.5
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
Zdroje
- java.math (Java SE 21 & JDK 21)
- BigDecimal (Java SE 21 & JDK 21)
- RoundingMode (Java SE 21 & JDK 21)
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html