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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Intl.DateTimeFormat și toLocaleDateString primesc opțiuni pentru fiecare parte a datei, iar fiecare opțiune are o listă fixă de valori, în engleză:
year,day,hour,minute,second:"numeric","2-digit";month:"numeric","2-digit","long","short","narrow";weekday,era:"long","short","narrow";dateStyle,timeStyle:"full","long","medium","short".
O valoare din afara listei aruncă Value <valoare> out of range for <metodă> options property <opțiune>. Mesajul îți spune exact ce valoare și ce opțiune sunt greșite.
Cel mai des: "full" folosit la month (amestec cu dateStyle: "full"), valori traduse în română ("lung", "scurt") sau un număr în loc de text (day: 2 în loc de "2-digit"). Limba afișării (de exemplu numele lunii în română) se alege din primul argument, "ro-RO", nu din opțiuni.
De ce apare: cauzele frecvente
1"full" la month
data.toLocaleDateString("ro-RO", { month: "full" });data.toLocaleDateString("ro-RO", { month: "long" });Numele complet al lunii se cere cu "long"; "full" există doar la dateStyle.
2Valori traduse în română
{ weekday: "lung", month: "scurt" }{ weekday: "long", month: "short" }Valorile opțiunilor sunt mereu în engleză; limba rezultatului vine din locale.
3Număr în loc de text
{ day: 2, month: 2 }{ day: "2-digit", month: "2-digit" }Formatul cu două cifre se cere cu textul "2-digit".
Repară eroarea, direct în pagină
Programul afișează data unei comenzi cu numele lunii scris complet, dar se oprește cu RangeError: Value full out of range for Date.prototype.toLocaleDateString options property month. Repară opțiunea month ca programul să afișeze Comanda din 15 martie 2024.
const data = new Date(2024, 2, 15);
const text = data.toLocaleDateString("ro-RO", {
day: "numeric",
month: "full",
year: "numeric",
});
console.log(`Comanda din ${text}`);Comanda din 15 martie 2024
Indiciu
Pentru numele complet al lunii, valoarea opțiunii month e "long".
Reparația
const data = new Date(2024, 2, 15);
const text = data.toLocaleDateString("ro-RO", {
day: "numeric",
month: "long",
year: "numeric",
});
console.log(`Comanda din ${text}`);De ce merge
Opțiunea month acceptă doar numeric, 2-digit, long, short și narrow; "full" e o valoare a lui dateStyle, nu a lui month, așa că formatorul a refuzat-o. Cu month: "long", luna apare cu numele complet, în limba din primul argument (ro-RO): martie. Lunile din new Date(2024, 2, 15) încep de la 0, deci 2 e martie.
Alte forme ale mesajului
RangeError: Value full out of range for Date.prototype.toLocaleDateString options property monthRangeError: Value lung out of range for Intl.DateTimeFormat options property weekdayRangeError: invalid value "full" for option month
Cum o eviți pe viitor
- Ține la îndemână lista valorilor permise pentru fiecare opțiune (o găsești în documentația
Intl.DateTimeFormat). - Pentru formate uzuale, folosește
dateStyle: "long"sau"full", mai simplu decât opțiunile separate. - Creează formatorul o singură dată (de exemplu
formatData) și refolosește-l. - Nu amesteca
dateStylecu opțiuni individuale camonth; combinația aruncă și eaTypeError.
Întrebări frecvente
Cum afișez data cu ziua săptămânii, ca „vineri, 15 martie 2024”?
Cu dateStyle: "full" și locale "ro-RO", sau cu opțiunile { weekday: "long", day: "numeric", month: "long", year: "numeric" }.
Pot combina dateStyle cu month?
Nu. dateStyle și timeStyle nu se combină cu opțiunile individuale; motorul aruncă TypeError. Alege una dintre variante.
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: 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: Invalid time zone specified: Europe/Bucuresti Opțiunea timeZone din Intl.DateTimeFormat sau toLocaleString are un nume de fus orar care nu există. Se folosesc identificatorii IANA, în engleză: "Europe/Bucharest", "Europe/London", "America/New_York", sau "UTC". Nu merg "Europe/Bucuresti", "EET+2" sau "Romania". Î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.
