Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Divisione BigDecimal con scala e modalità di arrotondamento esplicite

Questo overload di `divide` permette di impostare la scala del quoziente e scegliere la regola di arrotondamento. Il risultato ha la scala richiesta anche quando la divisione è esatta.

Versione: Java SE 21

Sintassi

public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)

BigDecimal quotient = dividend.divide(divisor, scale, roundingMode);

dividend.divide(divisor, scale, roundingMode) divide dividend per divisor. Entrambi gli operandi sono di tipo java.math.BigDecimal e non vengono modificati. L’argomento scale, di tipo int, imposta la scala del risultato. L’argomento di tipo java.math.RoundingMode indica come arrotondare se necessario.

Una scala di 2 dà due cifre dopo il separatore decimale, inclusi gli zeri finali. Con scala 0 il risultato è intero, mentre con scala -2 è un multiplo di 100. La scala non è il numero di cifre significative. HALF_UP sceglie il valore più vicino alla scala richiesta e, a parità di distanza, quello più lontano da zero.

La divisione per zero genera un’ArithmeticException. La stessa eccezione si verifica con UNNECESSARY se il quoziente esatto non si può rappresentare alla scala richiesta senza arrotondamento. Il valore esatto 0.5 si può rappresentare come 0.50 con scala 2 senza cambiarne il valore.

divide(divisor, roundingMode) usa la scala del dividendo. divide(divisor) richiede un risultato esatto e genera un’eccezione se lo sviluppo decimale non termina. divide(divisor, mathContext) usa la precisione e la modalità di arrotondamento del contesto invece di ricevere una scala di destinazione. Il vecchio overload che riceve la modalità di arrotondamento come int è deprecato; usa invece RoundingMode.

Esempi

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal one = BigDecimal.ONE;
        BigDecimal rounded = one.divide(BigDecimal.valueOf(8), 2, RoundingMode.HALF_UP);
        BigDecimal exact = one.divide(BigDecimal.valueOf(2), 2, RoundingMode.HALF_UP);

        System.out.println(rounded.toPlainString());
        System.out.println(exact.toPlainString());
    }
}

Risultato

0.13
0.50

Il quoziente esatto di `1 / 8` è `0.125`, quindi `HALF_UP` dà `0.13`. Il quoziente di `1 / 2` non richiede arrotondamento: `toPlainString()` stampa `0.50`, mantenendo lo zero finale richiesto dalla scala `2`.

Lezioni correlate

  • Java · Lezione 69 · Base · Versione: 2

Fonti