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

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

Източници