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"`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
API-urile Intl (și metodele toLocaleString, toLocaleDateString, localeCompare) primesc ca prim argument un locale: un cod de limbă în format BCP 47, de exemplu "ro", "ro-RO", "en-GB". Dacă textul nu respectă formatul (are underscore, spații, cuvinte întregi, e gol), motorul aruncă RangeError: Incorrect locale information provided.
Un cod corect ca format, dar pentru o limbă pe care motorul nu o are, nu dă eroare: se folosește limba implicită. Deci eroarea apare doar la coduri malformate.
Cauza cea mai frecventă e "ro_RO", formatul din Java, PHP, Linux (LANG=ro_RO.UTF-8) și din unele baze de date. Alte surse: setări citite din configurare ("ro_RO.UTF-8"), din profilul utilizatorului sau un "" gol.
De ce apare: cauzele frecvente
1Underscore în loc de cratimă
const pret = 1234.5;
console.log(pret.toLocaleString("ro_RO"));const pret = 1234.5;
console.log(pret.toLocaleString("ro-RO"));BCP 47 folosește cratimă între limbă și țară.
2Locale din sistem, cu encoding
const limba = "ro_RO.UTF-8"; // din LANG
new Intl.DateTimeFormat(limba);const limba = "ro_RO.UTF-8".split(".")[0].replace("_", "-");
new Intl.DateTimeFormat(limba);Elimini partea .UTF-8 și înlocuiești underscore-ul ca să obții ro-RO.
3Nume de limbă în loc de cod
data.toLocaleDateString("romana");data.toLocaleDateString("ro");Se folosesc codurile ISO de limbă (ro, en, de), nu numele lor.
Repară eroarea, direct în pagină
Programul de mai jos citește limba din setările sistemului (ro_RO.UTF-8) și formatează un preț, dar se oprește cu RangeError: Incorrect locale information provided. Repară funcția codLimba ca programul să afișeze Limba: ro-RO și Preț: 1.234,50.
const LANG = "ro_RO.UTF-8";
function codLimba(lang) {
return lang;
}
const limba = codLimba(LANG);
const pret = (1234.5).toLocaleString(limba, { minimumFractionDigits: 2 });
console.log(`Limba: ${limba}`);
console.log(`Preț: ${pret}`);Limba: ro-RO Preț: 1.234,50
Indiciu
Elimină partea de după punct și înlocuiește underscore-ul cu cratimă.
Reparația
const LANG = "ro_RO.UTF-8";
function codLimba(lang) {
return lang.split(".")[0].replace("_", "-");
}
const limba = codLimba(LANG);
const pret = (1234.5).toLocaleString(limba, { minimumFractionDigits: 2 });
console.log(`Limba: ${limba}`);
console.log(`Preț: ${pret}`);De ce merge
Formatul ro_RO.UTF-8 vine din setările Linux, dar Intl acceptă doar coduri BCP 47, cu cratimă și fără encoding. split(".")[0] păstrează ro_RO, iar replace("_", "-") îl face ro-RO. Cu un cod valid, toLocaleString aplică regulile românești: punct pentru mii, virgulă pentru zecimale.
Alte forme ale mesajului
RangeError: invalid language tag: "ro_RO"RangeError: Incorrect locale information provided at Number.toLocaleStringRangeError: Incorrect locale information provided at new DateTimeFormat
Cum o eviți pe viitor
- Scrie locale-urile cu cratimă:
"ro-RO","en-US". - Când primești coduri din alte sisteme (Java, PHP, Linux, baze de date), transformă-le într-un singur loc, cu o funcție.
- Validează un cod necunoscut cu
Intl.getCanonicalLocales(cod)într-untry...catch.
Întrebări frecvente
De ce "ro_RO" merge în Java și PHP?
Acolo convenția e diferită (ro_RO). JavaScript respectă strict standardul BCP 47, care folosește cratimă.
Ce se întâmplă cu un cod corect, dar neacceptat, ca "xx-YY"?
Nu primești eroare: motorul alege limba implicită a sistemului. Poți verifica ce s-a folosit cu new Intl.NumberFormat("xx-YY").resolvedOptions().locale.
Erori înrudite
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.` 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: toFixed() digits argument must be between 0 and 100 Ai dat lui `toFixed` un număr de zecimale negativ sau mai mare decât 100, de obicei dintr-o variabilă calculată greșit sau inversând argumentele. `toFixed(n)` acceptă `n` între 0 și 100. Verifică ce trimiți: `pret.toFixed(2)`, nu `pret.toFixed(-2)` sau `(2).toFixed(pret)`. Î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.
