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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Intl.RelativeTimeFormat formatează texte ca „ieri”, „peste 2 săptămâni”, „acum 3 ore”. Metoda format(valoare, unitate) primește un număr (negativ pentru trecut) și o unitate din listă fixă, în engleză: "second", "minute", "hour", "day", "week", "month", "quarter", "year", sau formele lor de plural ("days", "weeks"...). Orice altceva aruncă această RangeError, cu unitatea primită la final.
Greșelile tipice: unități traduse ("zile", "saptamani"), abrevieri ("d", "h", "min") sau unități care nu există aici ("millisecond"). Textul rezultat e în limba din constructor: new Intl.RelativeTimeFormat("ro") scrie în română, deși unitatea e dată în engleză.
Aceeași familie de mesaj apare la Intl.NumberFormat cu style: "unit": Invalid unit argument for Intl.NumberFormat() 'kilograme'. Acolo unitățile sunt tot în engleză și la singular: "kilogram", "kilometer", "liter", "percent".
De ce apare: cauzele frecvente
1Unitate în română
const rtf = new Intl.RelativeTimeFormat("ro");
rtf.format(-1, "zile");const rtf = new Intl.RelativeTimeFormat("ro");
rtf.format(-1, "day");Unitatea se dă în engleză; limba rezultatului e stabilită de "ro".
2Abreviere
rtf.format(3, "h");rtf.format(3, "hour");Abrevierile nu sunt acceptate; se scrie numele complet al unității.
3Unitate de măsură la NumberFormat
new Intl.NumberFormat("ro-RO", { style: "unit", unit: "kilograme" });new Intl.NumberFormat("ro-RO", { style: "unit", unit: "kilogram" });Unitățile sunt identificatori standard în engleză, la singular.
Repară eroarea, direct în pagină
Programul afișează când a fost plasată o comandă și când se livrează, cu texte relative în română, dar se oprește cu RangeError: Invalid unit argument for Intl.RelativeTimeFormat.prototype.format() 'zile'. Repară unitățile ca programul să afișeze Comanda: ieri și Livrare: peste 2 săptămâni.
const rtf = new Intl.RelativeTimeFormat("ro", { numeric: "auto" });
console.log(`Comanda: ${rtf.format(-1, "zile")}`);
console.log(`Livrare: ${rtf.format(2, "saptamani")}`);Comanda: ieri Livrare: peste 2 săptămâni
Indiciu
Unitățile se scriu în engleză: zi = "day", săptămână = "week".
Reparația
const rtf = new Intl.RelativeTimeFormat("ro", { numeric: "auto" });
console.log(`Comanda: ${rtf.format(-1, "day")}`);
console.log(`Livrare: ${rtf.format(2, "week")}`);De ce merge
format acceptă doar unitățile standard, în engleză, așa că "zile" a fost respins. Limba rezultatului vine din constructor ("ro"), deci cu "day" și "week" textele ies tot în română. Opțiunea numeric: "auto" transformă -1 day în cuvântul „ieri”, iar 2 week devine „peste 2 săptămâni”.
Alte forme ale mesajului
RangeError: Invalid unit argument for format() 'zile'RangeError: Invalid unit argument for Intl.NumberFormat() 'kilograme'
Cum o eviți pe viitor
- Păstrează unitățile în cod ca valori în engleză și traduce doar rezultatul (prin locale).
- Când unitatea vine din date, mapeaz-o explicit:
{ zile: "day", ore: "hour" }. - Folosește
{ numeric: "auto" }ca să obții „ieri”, „mâine” în loc de „acum 1 zi”. - Creează formatorul o dată și refolosește-l.
Întrebări frecvente
De ce nu există unitatea „millisecond”?
RelativeTimeFormat e gândit pentru texte citite de oameni („acum 5 minute”), unde secunda e cea mai mică unitate utilă.
Cum aleg unitatea potrivită automat?
Calculează diferența în secunde și alege unitatea după prag (sub 60: secunde, sub 3600: minute etc.). Formatorul nu face asta singur.
Erori înrudite
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"`. RangeError: Value full out of range for Intl.DateTimeFormat options property month O opțiune de formatare a datei are o valoare nepermisă, de exemplu month: "full" sau weekday: "lung". Pentru month valorile sunt "numeric", "2-digit", "long", "short", "narrow"; pentru weekday, "long", "short", "narrow". "full" merge doar la dateStyle și timeStyle. RangeError: Invalid currency code : euro `Intl.NumberFormat` (sau `toLocaleString`) cu `style: "currency"` a primit un cod de monedă care nu are forma corectă: trei litere ISO 4217, ca `"RON"`, `"EUR"`, `"USD"`. Nu merg `"euro"`, `"€"` sau `"lei "`. Dacă lipsește complet, mesajul e `Currency code is required with currency style.` Î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.
