java.lang.ArithmeticException: Rounding necessary
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
import java.math.BigDecimal
fun main() {
println(BigDecimal("19.995").setScale(2))
}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
import java.math.BigDecimal
fun main() {
val bucati = BigDecimal("2.5").intValueExact()
println(bucati)
}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ă 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.
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")
}Pret cu TVA: 23.79 lei
Indiciu
setScale(2, RoundingMode.HALF_UP) și importul java.math.RoundingMode.
Reparația
import java.math.BigDecimal
import java.math.RoundingMode
fun main() {
val pret = BigDecimal("19.99")
val cuTva = (pret * BigDecimal("1.19")).setScale(2, RoundingMode.HALF_UP)
println("Pret cu TVA: $cuTva lei")
}De ce merge
19.99 x 1.19 = 23.7881, cu patru zecimale. setScale(2) fără mod de rotunjire presupune că nu se pierde nicio cifră nenulă, iar aici se pierd 81, deci aruncă excepția. Cu RoundingMode.HALF_UP, valoarea se rotunjește la 23.79. Cu RoundingMode.DOWN ai fi obținut 23.78, deci alegerea modului contează.
Alte forme ale mesajului
Exception in thread "main" java.lang.ArithmeticException: Rounding necessaryjava.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
java.lang.ArithmeticException: Non-terminating decimal expansion; no exact representable decimal result. Ai împărțit două BigDecimal fără să spui câte zecimale vrei, iar rezultatul are zecimale infinite (10 / 3 = 3.333...). Dă scala și modul de rotunjire: a.divide(b, 2, RoundingMode.HALF_UP). java.lang.ArithmeticException: integer overflow Un calcul cu Math.addExact, multiplyExact sau toIntExact a depășit valoarea maximă a lui Int (2147483647). Funcțiile Exact aruncă excepția ca să nu primești un rezultat greșit. Fă calculul în Long (sau BigInteger pentru valori uriașe). java.lang.NumberFormatException: For input string: "abc" Ai apelat toInt() (sau toDouble(), toLong()) pe un text care nu e un număr valid: "abc", "12.5" pentru Int, "" sau " 7" cu spații. Folosește toIntOrNull() și tratează null, sau curăță textul înainte (trim()). Î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.
