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