CKTIS / Java
BigDecimal.setScale — zmena mierky a zaokrúhľovanie
Nastavte mierku hodnoty `BigDecimal` bez zmeny číselnej hodnoty alebo výslovne zvoľte spôsob zaokrúhlenia. Pôvodný objekt zostane nezmenený.
Verzia: Java SE 21
Syntax
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 inštančná metóda triedy java.math.BigDecimal. Nezáporná mierka udáva počet desatinných miest; mierka -1 zodpovedá násobkom desiatich. Mierka nie je presnosť (počet číslic hodnoty bez mierky). Metóda vracia BigDecimal, nie formátovaný text. Pôvodný objekt je nemenný, preto použite návratovú hodnotu; nemusí ísť o novovytvorený objekt.
setScale(int) zachováva číselnú hodnotu. V desatinnom zápise môže zvýšenie mierky pridať nuly na konci a zníženie bez zmeny hodnoty môže odstrániť iba nuly. Ak by bolo potrebné zaokrúhliť, metóda vyvolá výnimku ArithmeticException.
setScale(int, RoundingMode) použije zvolený režim z java.math.RoundingMode, ak zníženie mierky vyžaduje zaokrúhlenie. HALF_UP zvolí najbližšiu hodnotu v cieľovej mierke; pri rovnakej vzdialenosti zaokrúhľuje smerom od nuly. Pri mierke 2 sa tak 2.675 zmení na 2.68. UNNECESSARY vyžaduje presný výsledok a vedie k výnimke ArithmeticException, ak treba zaokrúhliť.
Preťažený variant setScale(int, int) je od Javy 9 zastaraný a vyvolá IllegalArgumentException, ak druhý argument nepredstavuje platný režim zaokrúhľovania. V novom kóde používajte variant s RoundingMode. Na presný desatinný vstup použite new BigDecimal("2.675") namiesto new BigDecimal(2.675), ktorý preberá binárnu aproximáciu typu double.
Prí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ýsledok
2.6750 2.675 2.68 ArithmeticException 2.675
Prvé dva riadky ukazujú pridanie a odstránenie koncovej nuly bez zmeny hodnoty. Tretí ukazuje zaokrúhlenie, štvrtý hlási zachytenú výnimku a posledný vypisuje nezmenenú pôvodnú hodnotu.
Súvisiace lekcie
- Java · Lekcia 4 · Základná · Verzia: 2
- Java · Lekcia 6 · Základná · Verzia: 2
- Java · Lekcia 69 · Základná · Verzia: 2