CKTIS / Java
BigDecimal — десетична аритметика и закръгляване
java.math.BigDecimal поддържа десетични числа с произволна точност, полезни, наред с другото, за парични изчисления. Научете как се създават стойности, извършват операции, задава мащаб, сравнява и закръглява изрично.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
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 е неизменяемо десетично число с произволна точност. BigDecimal(String) създава точна стойност от текст; BigDecimal.valueOf(long) създава стойност от цяло число. BigDecimal.valueOf(double) използва текстовото представяне на double, но не може да поправи предишни изчислителни грешки. Избягвайте new BigDecimal(0.1), ако искате да представите точно 0.1.
BigDecimal.add, BigDecimal.subtract и BigDecimal.multiply извършват събиране, изваждане и умножение; използвайте върнатия резултат. BigDecimal.ZERO е нула с мащаб 0. BigDecimal.compareTo сравнява числови стойности, като пренебрегва разликите в мащаба; equals отчита мащаба, затова смята 2.0 и 2.00 за различни.
BigDecimal.divide без параметри за закръгляване изисква точно и крайно десетично представяне. Извикването BigDecimal.ONE.divide(BigDecimal.valueOf(3)) хвърля ArithmeticException, защото точното частно няма крайно десетично представяне. За разлика от него изразът 1 / 3 в Java извършва целочислено деление и дава 0. Делението на нула също хвърля това изключение. Посочете мащаб и RoundingMode, когато закръгляването е приемливо. HALF_EVEN избира най-близката стойност, а при равенство — тази, чиято последна запазена цифра е четна.
BigDecimal.setScale задава мащаба, а не броя на значещите цифри; намаляването на мащаба може да изисква закръгляване. При неотрицателен мащаб той е броят на цифрите след десетичния знак. BigDecimal.stripTrailingZeros премахва крайните нули, без да променя стойността, и може да доведе до отрицателен мащаб. BigDecimal.toPlainString представя резултата без експонента; това не е форматиране на валута според локалните настройки.
Примери
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());
}
}Резултат
38.50 12.83 true 12.5
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- 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