...
Eroare Java · Formatare de text și printf

java.lang.IllegalArgumentException: Cannot format given Object as a Number

Pe scurt

Ai dat lui DecimalFormat.format (sau NumberFormat.format) un obiect care nu e număr, de obicei un String precum "12.5". Convertește întâi textul în număr (Double.parseDouble, new BigDecimal) și formatează numărul.

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

Ce înseamnă

DecimalFormat și NumberFormat formatează numere: int, long, double, BigDecimal și alte subclase ale lui Number. Metoda format are și o variantă care primește un Object oarecare (moștenită din clasa Format), deci codul compilează și cu un String. La rulare însă, formatter-ul verifică tipul și, dacă nu e număr, aruncă IllegalArgumentException: Cannot format given Object as a Number.

Apare des când valorile vin ca text: dintr-un fișier CSV, dintr-un JSON citit ca Map<String, Object>, dintr-o coloană de bază de date citită cu getString. Mesajul înrudit Cannot format given Object as a Date vine de la SimpleDateFormat.format când primește altceva decât un Date.

În stivă vezi DecimalFormat.format și linia ta. Uită-te ce tip are variabila trimisă: dacă e String sau Object, convertește-o înainte.

De ce apare: cauzele frecvente

1Preț păstrat ca text

Greșit
JAVA
String pret = "12.5";
String afisat = new DecimalFormat("0.00").format(pret);
Corect
JAVA
String pret = "12.5";
String afisat = new DecimalFormat("0.00").format(Double.parseDouble(pret));

Double.parseDouble transformă textul în număr, iar formatter-ul primește un double.

2Valoare citită ca Object dintr-un Map

Greșit
JAVA
Map<String, Object> rand = Map.of("total", "199.90");
format.format(rand.get("total"));
Corect
JAVA
Map<String, Object> rand = Map.of("total", "199.90");
format.format(new BigDecimal(rand.get("total").toString()));

Nu știi sigur ce tip are valoarea, deci o transformi explicit într-un număr.

3Dată formatată cu formatter de numere

Greșit
JAVA
NumberFormat nf = NumberFormat.getInstance();
nf.format(LocalDate.now());
Corect
JAVA
DateTimeFormatter df = DateTimeFormatter.ofPattern("dd.MM.yyyy");
df.format(LocalDate.now());

Fiecare tip de valoare are formatter-ul lui: numere cu NumberFormat, date cu DateTimeFormatter.

Repară tu

Repară eroarea, direct în pagină

Programul afișează prețurile citite dintr-un fișier, cu două zecimale, dar se oprește cu IllegalArgumentException: Cannot format given Object as a Number. Convertește textul în număr înainte de formatare, ca programul să afișeze 12.50 lei, 7.00 lei și 19.99 lei.

Codul care dă eroarea
JAVA
import java.text.*;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DecimalFormat format = new DecimalFormat("0.00", DecimalFormatSymbols.getInstance(Locale.US));
        String[] preturi = {"12.5", "7", "19.99"};
        for (String p : preturi) {
            System.out.println(format.format(p) + " lei");
        }
    }
}
După reparație, programul afișează
12.50 lei
7.00 lei
19.99 lei
Indiciu

Dă lui format un double obținut cu Double.parseDouble(p).

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Cannot format given Object as a Date
  • Exception in thread "main" java.lang.IllegalArgumentException: Cannot format given Object as a Number at java.base/java.text.DecimalFormat.format(DecimalFormat.java)

Cum o eviți pe viitor

  • Convertește datele din text în numere cât mai devreme, când le citești, nu când le afișezi.
  • Evită Object și Map<String, Object> pentru date cu tip cunoscut; folosește clase sau record-uri cu câmpuri tipizate.
  • Pentru bani, folosește BigDecimal și convertește textul cu new BigDecimal(text).
  • Fixează locale-ul formatter-ului (DecimalFormatSymbols.getInstance(Locale.US)), ca rezultatul să nu depindă de setările calculatorului.

Întrebări frecvente

De ce compilează, dacă format nu primește String?

Pentru că DecimalFormat moștenește din Format metoda format(Object), care acceptă orice obiect. Verificarea tipului se face abia la rulare.

De ce pe alt calculator apare virgulă în loc de punct?

DecimalFormat folosește implicit locale-ul sistemului. Cu locale românesc, separatorul zecimal e virgula. Dă explicit simbolurile dorite, de exemplu pentru Locale.US.

Erori înrudite

← Toate erorile Java

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ță Java de la zero, cu exerciții la fiecare lecție

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