java.lang.IllegalArgumentException: Cannot format given Object as a Number
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
String pret = "12.5";
String afisat = new DecimalFormat("0.00").format(pret);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
Map<String, Object> rand = Map.of("total", "199.90");
format.format(rand.get("total"));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
NumberFormat nf = NumberFormat.getInstance();
nf.format(LocalDate.now());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ă 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.
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");
}
}
}12.50 lei 7.00 lei 19.99 lei
Indiciu
Dă lui format un double obținut cu Double.parseDouble(p).
Reparația
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(Double.parseDouble(p)) + " lei");
}
}
}De ce merge
DecimalFormat știe să formateze doar numere, iar "12.5" este un String, chiar dacă arată ca un număr. Double.parseDouble(p) face conversia, iar șablonul 0.00 afișează mereu două zecimale. Simbolurile pentru Locale.US fixează punctul ca separator, indiferent de setările calculatorului.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Cannot format given Object as a DateException 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șiMap<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 cunew 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
java.lang.NumberFormatException: For input string: "12a" Integer.parseInt (sau Double.parseDouble) a primit un text care nu e un număr valid: litere, spații, virgulă zecimală sau un șir gol. Curăță textul (trim, înlocuiește virgula) și prinde NumberFormatException când datele vin de la utilizator. java.lang.ClassCastException: class java.lang.Integer cannot be cast to class java.lang.String Ai făcut un cast (Tip) obiect, dar obiectul real e de alt tip, de exemplu un Integer tratat ca String. Verifică tipul cu instanceof înainte de cast sau folosește conversii reale (String.valueOf, Integer.parseInt) în loc de cast. java.util.IllegalFormatConversionException: d != java.lang.Double În String.format sau printf, specificatorul nu se potrivește cu tipul valorii: %d (întreg) a primit un double sau un String. Folosește %s pentru orice valoare, %d doar pentru întregi, sau convertește valoarea înainte. Î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.
