...
Eroare C# · Excepții la rulare: null, conversii, aritmetică

System.FormatException: Format specifier was invalid.

Pe scurt

Ai cerut un format numeric care nu există pentru acel tip, de exemplu `"D2"` sau `"X2"` pe un `decimal` / `double` (aceste formate merg doar pe întregi). Pentru zecimale folosește `"F2"`, `"N2"` sau `"0.00"`, iar pentru `D` și `X` convertește întâi la `int`.

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

Ce înseamnă

Formatele standard sunt o literă, opțional urmată de un număr: C (monedă), D (întreg cu zerouri în față), E, F (zecimale fixe), G, N (cu separator de mii), P (procent), R, X (hexazecimal). Unele merg doar pe anumite tipuri: D și X doar pe tipuri întregi (int, long, byte). Când ceri unul dintre ele pe un double sau decimal, ori folosești o literă care nu e format standard ("Q", "L2"), primești System.FormatException: Format specifier was invalid..

Excepția apare la rulare, la ToString("..."), la string.Format("{0:...}") sau în interpolare ($"{x:D2}"). Locul exact e linia cu formatarea, chiar dacă valoarea vine de departe.

Reparații tipice:

  • zerouri în față la o valoare zecimală: x.ToString("00.00") sau convertești la int și folosești D2;
  • hexazecimal din double: ((int)x).ToString("X2");
  • două zecimale: F2 sau N2.

De ce apare: cauzele frecvente

1D2 pe un decimal

Greșit
C#
decimal ora = 9m;
Console.WriteLine(ora.ToString("D2"));
Corect
C#
decimal ora = 9m;
Console.WriteLine(((int)ora).ToString("D2"));

D2 adaugă zerouri doar pe tipuri întregi; după conversie afișează 09.

2Hexazecimal dintr-un double

Greșit
C#
double rosu = 255;
string hex = rosu.ToString("X2");
Corect
C#
double rosu = 255;
string hex = ((int)rosu).ToString("X2");

X lucrează doar pe întregi.

3Literă care nu e format standard

Greșit
C#
Console.WriteLine($"{pret:L2}");
Corect
C#
Console.WriteLine($"{pret:F2} lei");

L nu e un format; F2 dă două zecimale, iar unitatea se scrie ca text.

Repară tu

Repară eroarea, direct în pagină

Programul afișează ora de început a unei ședințe și culoarea ei în hexazecimal, dar se oprește cu System.FormatException: Format specifier was invalid. Repară formatările ca programul să afișeze Ora: 09:05 și Culoare: #FF8000.

Codul care dă eroarea
C#
double ora = 9, minut = 5;
double rosu = 255, verde = 128, albastru = 0;
Console.WriteLine($"Ora: {ora.ToString("D2")}:{minut.ToString("D2")}");
Console.WriteLine($"Culoare: #{rosu.ToString("X2")}{verde.ToString("X2")}{albastru.ToString("X2")}");
După reparație, programul afișează
Ora: 09:05
Culoare: #FF8000
Indiciu

Formatele D și X funcționează doar pe tipuri întregi.

Alte forme ale mesajului

  • Unhandled exception. System.FormatException: Format specifier was invalid.

Cum o eviți pe viitor

  • Folosește F2 / N2 pentru sume și D2 doar pentru întregi (ore, minute, numere de ordine).
  • Pentru formate speciale scrie un format personalizat cu 0 și # ("000.00", "#,##0.00").
  • Testează formatarea cu valori reale ale tipului folosit în program, nu doar cu literale int.

Întrebări frecvente

De ce merge 5.ToString("D2") și nu 5.0.ToString("D2")?

5 e int, deci acceptă D. 5.0 e double, iar formatul D nu e definit pentru tipurile cu virgulă.

E aceeași eroare ca Input string was not in a correct format?

Nu. Aceea apare la citirea unui număr dintr-un text (int.Parse) sau la un șir de format cu acolade greșite. Aceasta apare când litera de format nu se potrivește cu tipul valorii.

Erori înrudite

← Toate erorile C#

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

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