База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници