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

RangeError: Incorrect locale information provided

Pe scurt

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ă

Greșit
JavaScript
const pret = 1234.5;
console.log(pret.toLocaleString("ro_RO"));
Corect
JavaScript
const pret = 1234.5;
console.log(pret.toLocaleString("ro-RO"));

BCP 47 folosește cratimă între limbă și țară.

2Locale din sistem, cu encoding

Greșit
JavaScript
const limba = "ro_RO.UTF-8"; // din LANG
new Intl.DateTimeFormat(limba);
Corect
JavaScript
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

Greșit
JavaScript
data.toLocaleDateString("romana");
Corect
JavaScript
data.toLocaleDateString("ro");

Se folosesc codurile ISO de limbă (ro, en, de), nu numele lor.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Limba: ro-RO
Preț: 1.234,50
Indiciu

Elimină partea de după punct și înlocuiește underscore-ul cu cratimă.

Alte forme ale mesajului

  • RangeError: invalid language tag: "ro_RO"
  • RangeError: Incorrect locale information provided at Number.toLocaleString
  • RangeError: 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-un try...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

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