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

RangeError: Value full out of range for Intl.DateTimeFormat options property month

Pe scurt

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

Greșit
JavaScript
data.toLocaleDateString("ro-RO", { month: "full" });
Corect
JavaScript
data.toLocaleDateString("ro-RO", { month: "long" });

Numele complet al lunii se cere cu "long"; "full" există doar la dateStyle.

2Valori traduse în română

Greșit
JavaScript
{ weekday: "lung", month: "scurt" }
Corect
JavaScript
{ weekday: "long", month: "short" }

Valorile opțiunilor sunt mereu în engleză; limba rezultatului vine din locale.

3Număr în loc de text

Greșit
JavaScript
{ day: 2, month: 2 }
Corect
JavaScript
{ day: "2-digit", month: "2-digit" }

Formatul cu două cifre se cere cu textul "2-digit".

Repară tu

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.

Codul care dă eroarea
JavaScript
const data = new Date(2024, 2, 15);

const text = data.toLocaleDateString("ro-RO", {
  day: "numeric",
  month: "full",
  year: "numeric",
});

console.log(`Comanda din ${text}`);
După reparație, programul afișează
Comanda din 15 martie 2024
Indiciu

Pentru numele complet al lunii, valoarea opțiunii month e "long".

Alte forme ale mesajului

  • RangeError: Value full out of range for Date.prototype.toLocaleDateString options property month
  • RangeError: Value lung out of range for Intl.DateTimeFormat options property weekday
  • RangeError: 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 dateStyle cu opțiuni individuale ca month; combinația aruncă și ea TypeError.

Î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

← 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.