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