CKTIS / Java
BigDecimal — desetinná aritmetika a zaokrouhlování
java.math.BigDecimal podporuje desetinná čísla s libovolnou přesností, která se hodí mimo jiné pro peněžní výpočty. Seznamte se s vytvářením hodnot, aritmetickými operacemi, měřítkem, porovnáváním a explicitním zaokrouhlováním.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 neměnné desetinné číslo s libovolnou přesností. BigDecimal(String) vytvoří přesnou hodnotu z textu; BigDecimal.valueOf(long) ji vytvoří z celého čísla. BigDecimal.valueOf(double) používá textovou reprezentaci typu double, ale nedokáže opravit dřívější chyby výpočtu. Pokud chcete přesně hodnotu 0.1, vyhněte se new BigDecimal(0.1).
BigDecimal.add, BigDecimal.subtract a BigDecimal.multiply provádějí sčítání, odčítání a násobení; dále pracujte s vráceným výsledkem. BigDecimal.ZERO je nula s měřítkem 0. BigDecimal.compareTo porovnává číselné hodnoty a ignoruje rozdíly v měřítku; equals měřítko zohledňuje, takže považuje 2.0 a 2.00 za různé.
BigDecimal.divide bez parametrů zaokrouhlování vyžaduje přesný konečný desetinný rozvoj. Volání BigDecimal.ONE.divide(BigDecimal.valueOf(3)) vyvolá ArithmeticException, protože přesný podíl nemá konečný desetinný rozvoj. Naproti tomu výraz 1 / 3 v Javě provádí celočíselné dělení a jeho výsledkem je 0. Stejnou výjimku vyvolá také dělení nulou. Pokud je zaokrouhlení přijatelné, zadejte měřítko a RoundingMode. HALF_EVEN vybere nejbližší hodnotu a při shodné vzdálenosti tu, jejíž poslední zachovaná číslice je sudá.
BigDecimal.setScale nastavuje měřítko, nikoli počet platných číslic; jeho snížení může vyžadovat zaokrouhlení. U nezáporného měřítka jde o počet desetinných míst. BigDecimal.stripTrailingZeros odstraní koncové nuly, aniž změní hodnotu, a může vést k zápornému měřítku. BigDecimal.toPlainString vypíše výsledek bez exponentu; nejde o formátování měny závislé na místním nastavení.
Pří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ýsledek
38.50 12.83 true 12.5
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
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