...
Eroare Kotlin · Excepții la rulare

java.lang.ArithmeticException: Rounding necessary

Pe scurt

Ai cerut unui BigDecimal mai puține zecimale (setScale(1) pe 1.25) fără să spui cum se rotunjește, sau cu RoundingMode.UNNECESSARY. Dă un mod de rotunjire: setScale(1, RoundingMode.HALF_UP). Apare și la intValueExact() pe un număr cu zecimale.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

setScale(n) schimbă numărul de zecimale ale unui BigDecimal. Dacă noua scală e mai mare (1.2 → 1.20), nu se pierde nimic. Dacă e mai mică (1.25 → o zecimală), o cifră trebuie aruncată, deci e nevoie de o regulă de rotunjire. Fără ea, setScale(1) folosește implicit RoundingMode.UNNECESSARY, adică „garantez că nu e nevoie de rotunjire”, iar când garanția e falsă, apare ArithmeticException: Rounding necessary.

Același mesaj îl dau intValueExact(), longValueExact() și toBigIntegerExact() pe un BigDecimal care are zecimale nenule, și orice operație cu MathContext care folosește UNNECESSARY.

E o eroare utilă: te obligă să alegi conștient cum se rotunjesc banii.

De ce apare: cauzele frecvente

1setScale fără mod de rotunjire

Greșit
KOTLIN
import java.math.BigDecimal

fun main() {
    println(BigDecimal("19.995").setScale(2))
}
Corect
KOTLIN
import java.math.BigDecimal
import java.math.RoundingMode

fun main() {
    println(BigDecimal("19.995").setScale(2, RoundingMode.HALF_UP))
}

Cu HALF_UP, 19.995 devine 20.00.

2Conversie exactă la întreg

Greșit
KOTLIN
import java.math.BigDecimal

fun main() {
    val bucati = BigDecimal("2.5").intValueExact()
    println(bucati)
}
Corect
KOTLIN
import java.math.BigDecimal
import java.math.RoundingMode

fun main() {
    val bucati = BigDecimal("2.5").setScale(0, RoundingMode.DOWN).intValueExact()
    println(bucati)
}

Întâi alegi explicit rotunjirea (aici în jos), apoi conversia exactă reușește.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos rotunjește la 2 zecimale prețul cu TVA al unui produs, dar se oprește cu java.lang.ArithmeticException: Rounding necessary. Repară rotunjirea (folosește RoundingMode.HALF_UP) ca programul să afișeze Pret cu TVA: 23.79 lei.

Codul care dă eroarea
KOTLIN
import java.math.BigDecimal

fun main() {
    val pret = BigDecimal("19.99")
    val cuTva = (pret * BigDecimal("1.19")).setScale(2)
    println("Pret cu TVA: $cuTva lei")
}
După reparație, programul afișează
Pret cu TVA: 23.79 lei
Indiciu

setScale(2, RoundingMode.HALF_UP) și importul java.math.RoundingMode.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.ArithmeticException: Rounding necessary
  • java.lang.ArithmeticException: Rounding necessary

Cum o eviți pe viitor

Nu apela niciodată setScale(n) cu un singur argument pe valori calculate: scrie mereu și RoundingMode. Pune regula de rotunjire într-o singură funcție (fun Bani.rotunjit() = setScale(2, RoundingMode.HALF_UP)) și folosește-o peste tot, ca toate sumele să fie tratate la fel. Revizuiește în code review orice setScale cu un singur argument.

Întrebări frecvente

Când e util RoundingMode.UNNECESSARY?

Când vrei să verifici că o valoare chiar are cel mult n zecimale (de exemplu un preț primit de la API). Dacă nu are, excepția îți semnalează date greșite.

Care e diferența dintre DOWN și FLOOR?

DOWN taie spre zero (-2.7 → -2), FLOOR merge spre minus infinit (-2.7 → -3). Pentru numere pozitive dau același rezultat.

Erori înrudite

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.