RangeError: Value need to be finite number for Intl.RelativeTimeFormat.prototype.format()
Intl.RelativeTimeFormat.format a primit NaN sau Infinity în loc de număr, de obicei rezultatul unei diferențe între date în care una e invalidă (new Date("31.12.2026")). Verifică datele înainte de calcul și folosește formatul ISO "2026-12-31".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
new Intl.RelativeTimeFormat("ro").format(3, "day") scrie „peste 3 zile”, iar format(-2, "day") scrie „acum 2 zile”. Primul argument trebuie să fie un număr finit. Dacă e NaN, Infinity sau un text care nu se poate converti, metoda aruncă Value need to be finite number (formularea gramaticală ciudată vine chiar din motorul V8).
Aproape mereu valoarea vine dintr-un calcul cu date: (dataLivrare - azi) / 86400000. Dacă una dintre date e invalidă, scăderea dă NaN. Cel mai des, data e scrisă în format românesc ("31.12.2026"), pe care new Date nu îl înțelege sigur, sau vine undefined dintr-un API.
Verifică data cu Number.isNaN(data.getTime()) înainte de formatare și afișează un text de rezervă („dată necunoscută”) când lipsește.
De ce apare: cauzele frecvente
1Dată în format românesc
const livrare = new Date("31.12.2026");
const zile = Math.round((livrare - azi) / 86400000);
rtf.format(zile, "day");const livrare = new Date("2026-12-31");
const zile = Math.round((livrare - azi) / 86400000);
rtf.format(zile, "day");Formatul ISO AAAA-LL-ZZ e singurul garantat de standard. Cu el, diferența e un număr finit.
2Dată lipsă din răspunsul API
rtf.format((new Date(comanda.livrare) - azi) / 864e5, "day");const d = new Date(comanda.livrare);
if (Number.isNaN(d.getTime())) return "dată necunoscută";
rtf.format(Math.round((d - azi) / 864e5), "day");Un câmp lipsă dă o dată invalidă; verificarea oprește calculul înainte de format.
3Text în loc de număr
rtf.format("în 3", "day");rtf.format(3, "day");Valoarea trebuie să fie un număr; textul care nu e număr devine NaN.
Repară eroarea, direct în pagină
Pagina comenzii afișează în câte zile vine livrarea, dar data e scrisă în format românesc și format dă RangeError: Value need to be finite number for Intl.RelativeTimeFormat.prototype.format(). Repară data livrării ca programul să afișeze Livrare: peste 3 zile.
const azi = new Date("2026-12-28");
const livrare = new Date("31.12.2026");
const zile = Math.round((livrare - azi) / 86400000);
const rtf = new Intl.RelativeTimeFormat("ro", { numeric: "auto" });
console.log(`Livrare: ${rtf.format(zile, "day")}`);Livrare: peste 3 zile
Indiciu
Scrie data livrării în format ISO, AAAA-LL-ZZ.
Reparația
const azi = new Date("2026-12-28");
const livrare = new Date("2026-12-31");
const zile = Math.round((livrare - azi) / 86400000);
const rtf = new Intl.RelativeTimeFormat("ro", { numeric: "auto" });
console.log(`Livrare: ${rtf.format(zile, "day")}`);De ce merge
new Date("31.12.2026") nu e un format recunoscut, deci creează o dată invalidă, iar scăderea dă NaN. Intl.RelativeTimeFormat cere un număr finit și aruncă eroarea. Cu data în format ISO, diferența e de 3 zile, iar formatul românesc o scrie „peste 3 zile”.
Alte forme ale mesajului
RangeError: Value need to be finite number for Intl.RelativeTimeFormat.prototype.format()RangeError: invalid number value in RelativeTimeFormat.format()RangeError: Value need to be finite number for Intl.RelativeTimeFormat.prototype.formatToParts()
Cum o eviți pe viitor
- Păstrează datele în format ISO (
2026-12-31sau2026-12-31T10:00:00Z) în cod, baze de date și API-uri. - Scrie o funcție
parseazaDatacare validează și întoarcenullpentru date invalide. - Rotunjește diferențele cu
Math.roundînainte de formatare. - Afișează un text de rezervă pentru valorile lipsă, nu lăsa excepția să oprească pagina.
Întrebări frecvente
De ce new Date("31.12.2026") nu dă eroare?
Constructorul Date nu aruncă excepții pentru texte neînțelese, ci creează o dată invalidă (Invalid Date). Problema apare abia când o folosești în calcule sau la formatare.
Ce face opțiunea numeric: "auto"?
Scrie „mâine”, „ieri” sau „azi” în loc de „peste 1 zi”, „acum 1 zi” sau „peste 0 zile”.
Erori înrudite
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)`. RangeError: Invalid unit argument for Intl.RelativeTimeFormat.prototype.format() 'zile' Intl.RelativeTimeFormat.format(valoare, unitate) a primit o unitate necunoscută, de obicei scrisă în română ("zile", "ore"). Unitățile sunt în engleză: "second", "minute", "hour", "day", "week", "month", "quarter", "year" (sau la plural). Limba rezultatului vine din locale, de exemplu "ro". RangeError: Incorrect locale information provided Ai dat lui `toLocaleString`, `toLocaleDateString` sau `Intl.*` un cod de limbă scris greșit, de exemplu `"ro_RO"` (cu underscore) sau `"romana"`. Codurile valide au forma BCP 47 cu cratimă: `"ro-RO"`, `"ro"`, `"en-US"`. Î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.
