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