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

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

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

Източници