Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

RoundingMode — regole di arrotondamento decimale

java.math.RoundingMode specifica una regola di arrotondamento usata, tra le altre, da API come BigDecimal. HALF_UP sceglie il valore più vicino e, in caso di parità, arrotonda allontanandosi da zero, anche per i numeri negativi.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode è un tipo enumerato che specifica una regola di arrotondamento. RoundingMode.HALF_UP sceglie il valore più vicino; in caso di parità, arrotonda allontanandosi da zero. Con scala 2, 2.345 diventa 2.35 e -2.345 diventa -2.35.

UP arrotonda allontanandosi da zero, DOWN verso zero, CEILING verso l’infinito positivo e FLOOR verso l’infinito negativo. HALF_DOWN e HALF_EVEN scelgono il valore più vicino; in caso di parità, il primo arrotonda verso zero, mentre il secondo sceglie un risultato con l’ultima cifra mantenuta pari. UNNECESSARY richiede un risultato esatto; se è necessario arrotondare, viene generata un’ArithmeticException.

Per BigDecimal, setScale(2, RoundingMode.HALF_UP) imposta due cifre decimali, non due cifre significative. BigDecimal è immutabile: bisogna usare il valore restituito. Un costruttore che riceve una stringa, come new BigDecimal("2.345"), conserva il valore decimale esatto; un costruttore che riceve un double può introdurre gli effetti della rappresentazione binaria del numero.

L’esempio confronta HALF_UP con HALF_EVEN e mostra che il valore originale rimane invariato. La documentazione riguarda Java SE 21; l’ambiente di produzione non è attestato.

Esempi

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

public class Main {
    public static void main(String[] args) {
        BigDecimal positive = new BigDecimal("2.345");
        BigDecimal negative = new BigDecimal("-2.345");

        System.out.println(positive.setScale(2, RoundingMode.HALF_UP));
        System.out.println(negative.setScale(2, RoundingMode.HALF_UP));
        System.out.println(positive.setScale(2, RoundingMode.HALF_EVEN));
        System.out.println(positive);
    }
}

Risultato

2.35
-2.35
2.34
2.345

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti