Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje