...
Eroare JavaScript · Numere, BigInt și formatare (Intl)

RangeError: Invalid unit argument for Intl.RelativeTimeFormat.prototype.format() 'zile'

Pe scurt

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ă

Greșit
JavaScript
const rtf = new Intl.RelativeTimeFormat("ro");
rtf.format(-1, "zile");
Corect
JavaScript
const rtf = new Intl.RelativeTimeFormat("ro");
rtf.format(-1, "day");

Unitatea se dă în engleză; limba rezultatului e stabilită de "ro".

2Abreviere

Greșit
JavaScript
rtf.format(3, "h");
Corect
JavaScript
rtf.format(3, "hour");

Abrevierile nu sunt acceptate; se scrie numele complet al unității.

3Unitate de măsură la NumberFormat

Greșit
JavaScript
new Intl.NumberFormat("ro-RO", { style: "unit", unit: "kilograme" });
Corect
JavaScript
new Intl.NumberFormat("ro-RO", { style: "unit", unit: "kilogram" });

Unitățile sunt identificatori standard în engleză, la singular.

Repară tu

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.

Codul care dă eroarea
JavaScript
const rtf = new Intl.RelativeTimeFormat("ro", { numeric: "auto" });

console.log(`Comanda: ${rtf.format(-1, "zile")}`);
console.log(`Livrare: ${rtf.format(2, "saptamani")}`);
După reparație, programul afișează
Comanda: ieri
Livrare: peste 2 săptămâni
Indiciu

Unitățile se scriu în engleză: zi = "day", săptămână = "week".

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

← Toate erorile JavaScript

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ță 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.