Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

BigDecimal.setScale — promjena skale i zaokruživanje

Postavite skalu broja `BigDecimal` bez promjene njegove vrijednosti ili izričito odaberite način zaokruživanja. Izvorni objekt ostaje nepromijenjen.

Verzija: Java SE 21

Sintaksa

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 instancijska metoda klase java.math.BigDecimal. Nenegativna skala označava broj decimalnih mjesta; skala -1 odgovara višekratnicima broja deset. Skala nije isto što i preciznost (broj znamenaka neskalirane vrijednosti). Metoda vraća BigDecimal, a ne formatirani tekst. Izvorni je objekt nepromjenjiv, stoga upotrijebite povratnu vrijednost; za nju se ne mora stvoriti novi objekt.

setScale(int) zadržava brojčanu vrijednost. U decimalnom zapisu povećanje skale može dodati završne nule, a smanjenje bez promjene vrijednosti može ukloniti samo nule. Ako bi bilo potrebno zaokruživanje, metoda baca iznimku ArithmeticException.

setScale(int, RoundingMode) primjenjuje odabrani način iz java.math.RoundingMode kada smanjenje skale zahtijeva zaokruživanje. HALF_UP odabire najbližu vrijednost na zadanoj skali, a pri jednakoj udaljenosti zaokružuje u smjeru od nule: 2.675 postaje 2.68 na skali 2. UNNECESSARY zahtijeva točan rezultat i dovodi do iznimke ArithmeticException ako je potrebno zaokruživanje.

Preopterećena inačica setScale(int, int) zastarjela je od Jave 9 i baca IllegalArgumentException ako drugi argument ne predstavlja valjan način zaokruživanja. U novom kodu koristite inačicu s RoundingMode. Za točan unos decimalnog broja koristite new BigDecimal("2.675") umjesto new BigDecimal(2.675), koji preuzima binarnu aproksimaciju tipa double.

Primjeri

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

Rezultat

2.6750
2.675
2.68
ArithmeticException
2.675

Prva dva retka prikazuju dodavanje i uklanjanje završne nule bez promjene vrijednosti. Treći pokazuje zaokruživanje, četvrti javlja da je iznimka uhvaćena, a posljednji prikazuje nepromijenjenu izvornu vrijednost.

Povezane lekcije

  • Java · Lekcija 4 · Osnovno · Verzija: 2
  • Java · Lekcija 6 · Osnovno · Verzija: 2
  • Java · Lekcija 69 · Osnovno · Verzija: 2

Izvori