CKTIS / Java
BigDecimal.setScale — промяна на мащаба и закръгляване
Задайте мащаба на `BigDecimal`, като запазите стойността му или изрично изберете режим на закръгляване. Първоначалният обект остава непроменен.
Версия: Java SE 21
Синтаксис
public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)BigDecimal.setScale е метод на екземпляр от класа java.math.BigDecimal. Неотрицателният мащаб задава броя на знаците след десетичния разделител; мащаб -1 съответства на кратни на десет. Мащабът не е точността (броят на цифрите в немащабираната стойност). Методът връща BigDecimal, а не форматиран текст. Първоначалният обект е неизменяем, затова използвайте върнатата стойност; не е задължително да се създава нов обект.
setScale(int) запазва числовата стойност. В десетичния запис увеличаването на мащаба може да добави крайни нули, а намаляването му без промяна на стойността може да премахне само нули. Ако е необходимо закръгляване, методът хвърля ArithmeticException.
setScale(int, RoundingMode) прилага избрания режим от java.math.RoundingMode, когато намаляването на мащаба налага закръгляване. HALF_UP избира най-близката стойност при зададения мащаб, а при равни разстояния закръгля в посока от нулата: 2.675 става 2.68 при мащаб 2. UNNECESSARY изисква точен резултат и води до ArithmeticException, ако се налага закръгляване.
Претовареният вариант setScale(int, int) е остарял от Java 9 насам и хвърля IllegalArgumentException, ако вторият аргумент не обозначава валиден режим на закръгляване. В нов код използвайте варианта с RoundingMode. За точно въвеждане на десетично число използвайте new BigDecimal("2.675"), а не new BigDecimal(2.675), който приема двоичното приближение от тип double.
Примери
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal original = new BigDecimal("2.675");
BigDecimal padded = original.setScale(4);
System.out.println(padded.toPlainString());
System.out.println(padded.setScale(3).toPlainString());
System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());
try {
original.setScale(2);
} catch (ArithmeticException e) {
System.out.println("ArithmeticException");
}
System.out.println(original.toPlainString());
}
}Резултат
2.6750 2.675 2.68 ArithmeticException 2.675
Първите два реда показват добавяне и премахване на крайна нула без промяна на стойността. Третият показва закръгляването, четвъртият съобщава за прихванатото изключение, а последният показва непроменената първоначална стойност.
Свързани уроци
- Java · Урок 4 · Начално · Версия: 2
- Java · Урок 6 · Начално · Версия: 2
- Java · Урок 69 · Начално · Версия: 2