RangeError: Invalid time value
Ai apelat `toISOString()` (sau o formatare cu `Intl`) pe o dată invalidă, `Invalid Date`, creată dintr-un text pe care `new Date` nu l-a înțeles, de exemplu `"31.10.2026"`. Folosește formatul `"2026-10-31"` sau construiește data din numere: `new Date(2026, 9, 31)`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
new Date(text) nu aruncă eroare când nu înțelege textul: creează un obiect special, Invalid Date, a cărui valoare internă este NaN. Multe metode îl acceptă în tăcere (getFullYear() dă NaN, toString() dă "Invalid Date"), dar toISOString(), JSON.stringify cu date în unele contexte și formatarea cu Intl.DateTimeFormat aruncă RangeError: Invalid time value.
Formatul garantat de JavaScript este ISO: "2026-10-31" sau "2026-10-31T14:30:00". Formatele locale ("31.10.2026", "31/10/2026") nu sunt interpretate corect de new Date.
Alte surse: o dată construită din undefined (new Date(undefined)), din calcule cu NaN sau o dată ca "2026-02-30". Verifici o dată cu isNaN(data.getTime()) sau Number.isNaN(data.getTime()).
De ce apare: cauzele frecvente
1Dată în format românesc
const data = new Date("31.10.2026");
console.log(data.toISOString());const [zi, luna, an] = "31.10.2026".split(".").map(Number);
const data = new Date(Date.UTC(an, luna - 1, zi));
console.log(data.toISOString());new Date nu înțelege formatul cu puncte. Desfaci textul și construiești data din numere; lunile încep de la 0.
2Câmp lipsă, deci new Date(undefined)
const comanda = { dataLivrare: "2026-11-05" };
new Date(comanda.data).toISOString();const comanda = { dataLivrare: "2026-11-05" };
new Date(comanda.dataLivrare).toISOString();comanda.data nu există, iar new Date(undefined) este o dată invalidă.
3Dată care nu există în calendar
new Date("2026-02-30").toISOString();const d = new Date("2026-02-30");
if (Number.isNaN(d.getTime())) console.log("Dată invalidă");Validează datele introduse de utilizator înainte să le folosești.
Repară eroarea, direct în pagină
Programul de mai jos primește data unei programări în formatul românesc zi.lună.an și ar trebui să o afișeze în format ISO. Se oprește cu RangeError: Invalid time value. Desfă textul în zi, lună și an și construiește data cu Date.UTC, ca programul să afișeze 2026-11-14 și sâmbătă.
const text = "14.11.2026";
const zile = ["duminică", "luni", "marți", "miercuri", "joi", "vineri", "sâmbătă"];
const data = new Date(text);
console.log(data.toISOString().slice(0, 10));
console.log(zile[data.getUTCDay()]);2026-11-14 sâmbătă
Indiciu
"14.11.2026".split(".").map(Number) îți dă [14, 11, 2026]. Lunile din Date.UTC încep de la 0.
Reparația
const text = "14.11.2026";
const zile = ["duminică", "luni", "marți", "miercuri", "joi", "vineri", "sâmbătă"];
const [zi, luna, an] = text.split(".").map(Number);
const data = new Date(Date.UTC(an, luna - 1, zi));
console.log(data.toISOString().slice(0, 10));
console.log(zile[data.getUTCDay()]);De ce merge
new Date("14.11.2026") nu recunoaște formatul și creează o dată invalidă, iar toISOString() refuză să o formateze. Desfăcând textul obții numerele 14, 11 și 2026; Date.UTC(an, luna - 1, zi) construiește data în UTC (luna 10 înseamnă noiembrie, pentru că numărătoarea începe de la 0), deci rezultatul nu depinde de fusul orar al calculatorului. getUTCDay() dă 6, adică sâmbătă.
Alte forme ale mesajului
Invalid DateRangeError: Invalid time value at Date.toISOStringRangeError: date value is not finite in DateTimeFormat.format()
Cum o eviți pe viitor
- Păstrează și transmite datele în format ISO (
"2026-10-31"). - Pentru formate locale, desface textul manual și folosește
new Date(an, luna - 1, zi)sauDate.UTC. - După orice conversie din text, verifică
Number.isNaN(data.getTime()). - Pentru lucru serios cu date (fusuri orare, formatări), folosește o bibliotecă dedicată.
Întrebări frecvente
De ce console.log(new Date("abc")) nu dă eroare?
Pentru că o dată invalidă e tot un obiect Date. Doar unele metode (toISOString, formatarea cu Intl) aruncă eroare când îl primesc.
De ce luna din new Date(2026, 9, 31) e 9 pentru octombrie?
În constructorul cu numere, lunile sunt numerotate de la 0 (ianuarie) la 11 (decembrie). În textele ISO, lunile sunt normale (10 pentru octombrie).
Erori înrudite
RangeError: Invalid array length Ai cerut un tablou cu o lungime imposibilă: negativă, cu zecimale, `NaN` sau mai mare decât limita de aproximativ 4,29 miliarde. Cel mai des, `new Array(n)` primește un `n` calculat greșit. Verifică valoarea lui `n` înainte să creezi tabloul. SyntaxError: "undefined" is not valid JSON Ai dat lui `JSON.parse` valoarea `undefined` în loc de un text JSON, de obicei o variabilă goală, o proprietate scrisă greșit sau un rezultat lipsă. `JSON.parse` o transformă în textul „undefined”, care nu e JSON. Verifică de unde vine valoarea și tratează cazul în care lipsește. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
