CKTIS / Java
RoundingMode — правила за закръгляване на десетични числа
java.math.RoundingMode задава правило за закръгляване, използвано от API като BigDecimal. HALF_UP избира най-близката стойност, а при равенство закръглява от нулата, включително за отрицателни числа.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
value.setScale(newScale, RoundingMode.HALF_UP)java.math.RoundingMode е изброим тип, който задава правило за закръгляване. RoundingMode.HALF_UP избира най-близката стойност; при равенство закръглява от нулата. При скала 2 2.345 става 2.35, а -2.345 става -2.35.
UP закръглява от нулата, DOWN към нулата, CEILING към положителна безкрайност, а FLOOR към отрицателна безкрайност. HALF_DOWN и HALF_EVEN избират най-близката стойност; при равенство първият закръглява към нулата, а вторият избира резултат, чиято последна запазена цифра е четна. UNNECESSARY изисква точен резултат; ако е необходимо закръгляване, се хвърля ArithmeticException.
При BigDecimal setScale(2, RoundingMode.HALF_UP) задава две цифри след десетичния разделител, а не две значещи цифри. BigDecimal е неизменяем: използвайте върнатата стойност. Конструктор с низ, например new BigDecimal("2.345"), запазва точната десетична стойност; конструктор с double може да внесе ефекти от двоичното представяне на числото.
Примерът сравнява HALF_UP с HALF_EVEN и показва, че първоначалната стойност остава непроменена. Документацията обхваща Java SE 21; производствената среда не е удостоверена.
Примери
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal positive = new BigDecimal("2.345");
BigDecimal negative = new BigDecimal("-2.345");
System.out.println(positive.setScale(2, RoundingMode.HALF_UP));
System.out.println(negative.setScale(2, RoundingMode.HALF_UP));
System.out.println(positive.setScale(2, RoundingMode.HALF_EVEN));
System.out.println(positive);
}
}Резултат
2.35 -2.35 2.34 2.345
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.