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

java.util.UnknownFormatConversionException: Conversion = 'i'

Pe scurt

Ai folosit în String.format sau printf un specificator care nu există în Java, de exemplu %i (din C) sau %D. Pentru întregi folosește %d, pentru text %s; ca să afișezi semnul procent, scrie %%.

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

Ce înseamnă

Java recunoaște un set fix de litere după %: d (întreg), s (text), f (zecimal), c (caracter), b (boolean), x (hexazecimal), n (rând nou), % (semnul procent) și câteva altele. Dacă după % urmează altă literă, primești UnknownFormatConversionException, iar mesajul o arată: Conversion = 'i'.

Cauzele tipice:

  • obiceiuri din C sau Python: %i pentru întregi, %u;
  • litere mari care nu au variantă mare: %D, %F;
  • un % scris în text, urmat de o literă care nu e specificator, de exemplu "Discount 20%!" sau "100%k".

Eroarea apare doar la rulare. În stivă vezi Formatter.parse sau FormatSpecifier, apoi linia ta. Caută în șablon fiecare % și verifică litera de după el.

De ce apare: cauzele frecvente

1%i din C pentru întregi

Greșit
JAVA
String s = String.format("Ai %i mesaje noi", 3);
Corect
JAVA
String s = String.format("Ai %d mesaje noi", 3);

În Java, întregii se formatează doar cu %d.

2Literă mare care nu există

Greșit
JAVA
String s = String.format("Cod: %D", 42);
Corect
JAVA
String s = String.format("Cod: %d", 42);

%D nu există. Unele litere au variantă mare (%S, %X scriu cu majuscule), dar nu toate.

3Procent urmat de o literă în text

Greșit
JAVA
String s = String.format("Stoc: %s, ocupat 80%k", stoc);
Corect
JAVA
String s = String.format("Stoc: %s, ocupat 80%%k", stoc);

%% afișează un semn procent, iar litera de după rămâne text.

Repară tu

Repară eroarea, direct în pagină

Programul afișează câte mesaje necitite are un utilizator, dar se oprește cu UnknownFormatConversionException: Conversion = 'i'. Repară specificatorul, ca programul să afișeze Dan, ai 3 mesaje necitite.

Codul care dă eroarea
JAVA
public class Main {
    public static void main(String[] args) {
        String nume = "Dan";
        int necitite = 3;
        System.out.println(String.format("%s, ai %i mesaje necitite", nume, necitite));
    }
}
După reparație, programul afișează
Dan, ai 3 mesaje necitite
Indiciu

În Java, întregii se formatează cu %d.

Alte forme ale mesajului

  • java.util.UnknownFormatConversionException: Conversion = 'D'
  • java.util.UnknownFormatConversionException: Conversion = 'u'
  • java.util.UnknownFormatConversionException: Conversion = '%'

Cum o eviți pe viitor

  • Ține minte specificatorii de bază: %s, %d, %f, %n, %%.
  • Când textul conține procente, scrie-le %% sau concatenează textul în afara șablonului.
  • Nu folosi texte de la utilizator ca șablon de format: un % din ele poate arunca excepții. Pune-le ca argument pentru %s.
  • Rulează măcar o dată fiecare mesaj formatat, inclusiv pe cele din ramurile de eroare.

Întrebări frecvente

E diferit de IllegalFormatConversionException?

Da. Unknown... înseamnă că litera nu există deloc. Illegal... înseamnă că litera există, dar nu se potrivește cu tipul valorii, de exemplu %d cu un double.

De ce un text de la utilizator mi-a stricat String.format?

Pentru că l-ai folosit ca șablon. Dacă textul conține %, Java încearcă să-l interpreteze. Scrie String.format("%s", text) sau folosește direct textul.

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.