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

System.ArgumentOutOfRangeException: Year, Month, and Day parameters describe an un-representable DateTime.

Pe scurt

Ai creat o dată care nu există: 30 februarie, 31 aprilie, luna 13, ziua 0. `new DateTime(an, luna, zi)` verifică fiecare valoare. Pentru ultima zi din lună folosește `DateTime.DaysInMonth(an, luna)`, iar pentru calcule pornește de la o dată validă și folosește `AddDays` / `AddMonths`.

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

Ce înseamnă

Constructorul new DateTime(an, luna, zi) acceptă doar date care există în calendar: luna între 1 și 12, ziua între 1 și numărul de zile al lunii respective (inclusiv 29 februarie doar în anii bisecți), anul între 1 și 9999. Altfel aruncă ArgumentOutOfRangeException: Year, Month, and Day parameters describe an un-representable DateTime.

Cazuri frecvente:

  • calculezi „sfârșitul lunii” cu ziua 31 pentru orice lună;
  • aduni manual o lună (luna + 1) și ajungi la 13 în decembrie;
  • ai inversat ziua și luna la citirea unei date (05/13/2024 citită ca zi/lună);
  • ai pus 29 februarie într-un an care nu e bisect.

O variantă înrudită este Hour, Minute, and Second parameters describe an un-representable DateTime., când ora e 24 sau mai mare, ori minutele/secundele depășesc 59.

Soluția sigură: pornește de la o dată validă (de exemplu prima zi a lunii) și lasă AddMonths, AddDays să facă trecerea între luni și ani.

De ce apare: cauzele frecvente

1Ziua 31 pentru orice lună

Greșit
C#
var sfarsit = new DateTime(2024, luna, 31);
Corect
C#
var sfarsit = new DateTime(2024, luna, DateTime.DaysInMonth(2024, luna));

DaysInMonth întoarce 28, 29, 30 sau 31, în funcție de lună și an.

2Luna următoare calculată manual

Greșit
C#
var urmatoarea = new DateTime(data.Year, data.Month + 1, 1);
Corect
C#
var urmatoarea = new DateTime(data.Year, data.Month, 1).AddMonths(1);

În decembrie, Month + 1 dă 13. AddMonths trece corect în ianuarie anul următor.

3Ora 24

Greșit
C#
var miezulNoptii = new DateTime(2024, 3, 10, 24, 0, 0);
Corect
C#
var miezulNoptii = new DateTime(2024, 3, 10).AddDays(1);

Orele merg de la 0 la 23. Miezul nopții de la final de zi e ora 0 a zilei următoare.

Repară tu

Repară eroarea, direct în pagină

Programul afișează data scadenței facturilor, care este ultima zi a lunii, dar se oprește cu System.ArgumentOutOfRangeException: Year, Month, and Day parameters describe an un-representable DateTime. Repară-l ca să afișeze Scadenta luna 1: 31.01.2024, Scadenta luna 2: 29.02.2024, Scadenta luna 4: 30.04.2024.

Codul care dă eroarea
C#
foreach (int luna in new[] { 1, 2, 4 })
{
    var scadenta = new DateTime(2024, luna, 31);
    Console.WriteLine($"Scadenta luna {luna}: {scadenta:dd.MM.yyyy}");
}
După reparație, programul afișează
Scadenta luna 1: 31.01.2024
Scadenta luna 2: 29.02.2024
Scadenta luna 4: 30.04.2024
Indiciu

Nu toate lunile au 31 de zile; există o metodă care îți spune câte zile are o lună.

Alte forme ale mesajului

  • System.ArgumentOutOfRangeException: Hour, Minute, and Second parameters describe an un-representable DateTime.
  • System.ArgumentOutOfRangeException: The added or subtracted value results in an un-representable DateTime. (Parameter 'value')
  • System.ArgumentOutOfRangeException: Year, Month, and Day parameters describe an un-representable DateOnly.

Cum o eviți pe viitor

  • Nu construi date „la mână” din componente calculate; folosește AddDays, AddMonths, AddYears.
  • Pentru ultima zi din lună: DateTime.DaysInMonth(an, luna).
  • Pentru texte, folosește DateTime.TryParseExact cu formatul exact (dd.MM.yyyy), ca ziua și luna să nu fie inversate.

Întrebări frecvente

De ce AddMonths(1) pe 31 ianuarie dă 29 februarie?

Pentru că AddMonths păstrează ziua dacă poate și altfel o coboară la ultima zi validă a lunii. Așa nu ajunge niciodată la o dată imposibilă.

Cum verific dacă o dată există fără excepție?

Verifică luna (1-12) și ziua cu DateTime.DaysInMonth, sau încearcă DateTime.TryParseExact pe textul datei.

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.