Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

BigDecimal.setScale — změna měřítka a zaokrouhlování

Nastavte měřítko hodnoty `BigDecimal` a zachovejte její číselnou hodnotu, nebo výslovně zvolte způsob zaokrouhlení. Původní objekt se nezmění.

Verze: Java SE 21

Syntaxe

public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)

BigDecimal.setScale je instanční metoda třídy java.math.BigDecimal. Nezáporné měřítko udává počet desetinných míst; měřítko -1 odpovídá násobkům deseti. Měřítko není totéž co přesnost (počet číslic hodnoty bez měřítka). Metoda vrací BigDecimal, nikoli formátovaný text. Původní objekt je neměnný, proto použijte návratovou hodnotu; nemusí jít o nově vytvořený objekt.

setScale(int) zachovává číselnou hodnotu. V desetinném zápisu může zvýšení měřítka přidat nuly na konci a snížení bez změny hodnoty může odstranit jen nuly. Pokud by bylo nutné zaokrouhlit, metoda vyvolá výjimku ArithmeticException.

setScale(int, RoundingMode) použije zvolený režim z java.math.RoundingMode, pokud snížení měřítka vyžaduje zaokrouhlení. HALF_UP vybírá nejbližší hodnotu v cílovém měřítku; při stejné vzdálenosti zaokrouhluje směrem od nuly. Z 2.675 tak při měřítku 2 vznikne 2.68. UNNECESSARY vyžaduje přesný výsledek a vede k výjimce ArithmeticException, pokud je nutné zaokrouhlit.

Přetížená varianta setScale(int, int) je od Javy 9 zastaralá a vyvolá IllegalArgumentException, pokud druhý argument nepředstavuje platný režim zaokrouhlování. V novém kódu používejte variantu s RoundingMode. Pro přesný desetinný vstup použijte new BigDecimal("2.675") místo new BigDecimal(2.675), které přebírá binární aproximaci typu double.

Příklady

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());
    }
}

Výsledek

2.6750
2.675
2.68
ArithmeticException
2.675

První dva řádky ukazují přidání a odebrání koncové nuly beze změny hodnoty. Třetí ukazuje zaokrouhlení, čtvrtý hlásí zachycenou výjimku a poslední vypisuje nezměněnou původní hodnotu.

Související lekce

  • Java · Lekce 4 · Základní · Verze: 2
  • Java · Lekce 6 · Základní · Verze: 2
  • Java · Lekce 69 · Základní · Verze: 2

Zdroje