System.ArgumentOutOfRangeException: Year, Month, and Day parameters describe an un-representable DateTime.
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/2024citită 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ă
var sfarsit = new DateTime(2024, luna, 31);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
var urmatoarea = new DateTime(data.Year, data.Month + 1, 1);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
var miezulNoptii = new DateTime(2024, 3, 10, 24, 0, 0);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ă 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.
foreach (int luna in new[] { 1, 2, 4 })
{
var scadenta = new DateTime(2024, luna, 31);
Console.WriteLine($"Scadenta luna {luna}: {scadenta:dd.MM.yyyy}");
}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ă.
Reparația
foreach (int luna in new[] { 1, 2, 4 })
{
var scadenta = new DateTime(2024, luna, DateTime.DaysInMonth(2024, luna));
Console.WriteLine($"Scadenta luna {luna}: {scadenta:dd.MM.yyyy}");
}De ce merge
Programul construia data cu ziua 31 pentru fiecare lună, iar 31 februarie nu există, deci constructorul DateTime arunca excepția. DateTime.DaysInMonth(2024, luna) întoarce numărul real de zile: 31 pentru ianuarie, 29 pentru februarie 2024 (an bisect) și 30 pentru aprilie, așa că fiecare dată e validă.
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.TryParseExactcu 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
System.FormatException: The input string 'abc' was not in a correct format. `int.Parse` (sau `double.Parse`, `Convert.ToInt32`) a primit un text care nu este un număr valid: litere, șir gol, zecimale într-un `int`. Folosește `int.TryParse(text, out int n)` și tratează cazul în care întoarce `false`. System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index') Ai accesat într-o listă (`List<T>`) un indice care nu există: negativ sau mai mare ori egal cu `Count`. Indicii valizi sunt de la 0 la `Count - 1`; verifică bucla (`i < lista.Count`) și dacă lista are elementele la care te aștepți. System.OverflowException: Value was either too large or too small for an Int32. Numărul pe care încerci să-l citești sau să-l convertești nu încape în tipul cerut: un `int` ține valori doar între -2.147.483.648 și 2.147.483.647. Folosește un tip mai mare (`long`, `decimal`) sau validează valoarea înainte. Î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.
