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

CKTIS / Java

BigDecimal: точни десетични изчисления, скала и сравнение

Четете десетични числа без преобразуване през `double`, изчислявайте точно, задавайте скала и правило за закръгляне и сравнявайте числа независимо от скалата.

Версия: Java SE 21

Синтаксис

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.RoundingMode

В Java SE 21 конструкторът BigDecimal(String) от пакета java.math прочита десетична стойност точно, без преобразуване през double. Използвайте десетична точка, а не запетая; интервали и други празни знаци, както и разделители между групи цифри, не се допускат. Невалидният запис води до NumberFormatException. Без експонента скалата е броят на цифрите след точката, включително крайните нули; ако е посочена експонента, тя се изважда от тази скала.

Методите с един аргумент BigDecimal.add и BigDecimal.multiply връщат точната сума и точното произведение. Скалата на сумата е по-голямата от скалите на операндите, а предпочитаната скала на произведението е сборът им. В JDK 21, ако този сбор е извън диапазона на int, умножението може да хвърли ArithmeticException. Ако обаче обектът, върху който се извиква методът (this), има стойност нула, методът връща нула със скала, ограничена до най-близката граница на диапазона на int. Претоварените варианти с MathContext могат да закръглят според този контекст. Обектите BigDecimal са неизменяеми: запазете върнатия резултат, тъй като операндите не се променят.

BigDecimal.setScale задава скалата на резултата. setScale(int) хвърля ArithmeticException, ако е нужно закръгляне; setScale(int, RoundingMode) позволява да изберете правило. HALF_UP закръгля до най-близката стойност, а при равни разстояния — в посока от нулата. UNNECESSARY хвърля ArithmeticException, ако е необходимо закръгляне. Претовареният вариант setScale(int, int) е остарял.

BigDecimal.stripTrailingZeros премахва крайните нули от представянето, без да променя стойността. Скалата може да стане отрицателна, както при 600.0 след премахването на нулите (скала -2); за нула методът връща BigDecimal.ZERO. Излизането извън допустимия диапазон на скалата води до ArithmeticException. BigDecimal.toPlainString връща текст без експонента и без регионално форматиране. За фиксиран брой цифри след точката първо задайте скалата. При повторно прочитане на текста се запазва стойността, но не непременно скалата.

BigDecimal.compareTo сравнява числата независимо от скалата: връща -1, 0 или 1, когато първият операнд е съответно по-малък от втория, равен на него или по-голям. За числово равенство използвайте a.compareTo(b) == 0; equals изисква еднаква стойност и скала, затова за 2.0 и 2.00 връща false.

Примери

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));
    }
}

Резултат

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

Точният резултат `7.505` се закръгля до `7.51`. След премахването на нулите от `600.0` скалата е `-2`, но текстът без експонента е `600`. Сравнението с `600.00` дава `0`, докато `equals` връща `false`.

Свързани уроци

  • Java · Урок 60 · Средно · Версия: 2

Източници