RangeError: maximumFractionDigits value is out of range.
La Intl.NumberFormat sau toLocaleString, maximumFractionDigits e invalid: mai mic decât minimumFractionDigits (min 2, max 1), peste 100 sau nu e număr. Pune maximumFractionDigits mai mare sau egal cu minimumFractionDigits; pentru exact două zecimale, setează-le pe amândouă la 2.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Intl.NumberFormat (și numar.toLocaleString(locale, optiuni)) controlează zecimalele prin două opțiuni:
minimumFractionDigits: câte zecimale se afișează cel puțin (completează cu zerouri);maximumFractionDigits: câte zecimale se afișează cel mult (rotunjește).
Amândouă trebuie să fie numere întregi între 0 și 100, iar minimul nu poate depăși maximul. Dacă maximumFractionDigits e mai mic decât minimul, e peste 100 sau nu se poate transforma într-un număr ("doua"), motorul aruncă această RangeError. Pentru minim invalid, mesajul e minimumFractionDigits value is out of range.
Situația cea mai frecventă: vrei „exact două zecimale”, pui minimumFractionDigits: 2 și lași un maximumFractionDigits: 1 rămas din altă variantă, sau le inversezi. În versiuni mai vechi de Chrome, eroarea apărea și la style: "currency" cu maximumFractionDigits: 0, pentru că minimul implicit al monedei era 2; acolo setează și minimumFractionDigits: 0.
De ce apare: cauzele frecvente
1Minim mai mare decât maxim
n.toLocaleString("ro-RO", { minimumFractionDigits: 2, maximumFractionDigits: 1 });n.toLocaleString("ro-RO", { minimumFractionDigits: 2, maximumFractionDigits: 2 });Pentru un număr fix de zecimale, minimul și maximul sunt egale.
2Monedă fără zecimale în browsere mai vechi
new Intl.NumberFormat("ro-RO", {
style: "currency", currency: "RON", maximumFractionDigits: 0,
});new Intl.NumberFormat("ro-RO", {
style: "currency", currency: "RON",
minimumFractionDigits: 0, maximumFractionDigits: 0,
});Moneda are implicit minim 2 zecimale; setând și minimul la 0, combinația e validă peste tot.
3Valoare care nu e număr
const zecimale = setari.zecimale; // "doua"
new Intl.NumberFormat("ro-RO", { maximumFractionDigits: zecimale });const zecimale = Number.parseInt(setari.zecimale, 10);
new Intl.NumberFormat("ro-RO", { maximumFractionDigits: Number.isNaN(zecimale) ? 2 : zecimale });Valoarea trebuie să fie un întreg valid între 0 și 100.
Repară eroarea, direct în pagină
Programul afișează totalul unui coș cu exact două zecimale, după regulile românești, dar se oprește cu RangeError: maximumFractionDigits value is out of range. Repară opțiunile formatorului ca programul să afișeze Total: 1.234,50 lei.
const format = new Intl.NumberFormat("ro-RO", {
minimumFractionDigits: 2,
maximumFractionDigits: 1,
});
console.log(`Total: ${format.format(1234.5)} lei`);Total: 1.234,50 lei
Indiciu
Pentru exact două zecimale, minimul și maximul trebuie să fie egale.
Reparația
const format = new Intl.NumberFormat("ro-RO", {
minimumFractionDigits: 2,
maximumFractionDigits: 2,
});
console.log(`Total: ${format.format(1234.5)} lei`);De ce merge
minimumFractionDigits: 2 cerea cel puțin două zecimale, iar maximumFractionDigits: 1 cel mult una, o combinație imposibilă, deci formatorul a aruncat RangeError. Cu amândouă la 2, numărul are mereu exact două zecimale: 1234.5 devine 1.234,50, cu punct pentru mii și virgulă pentru zecimale, ca în limba română.
Alte forme ale mesajului
RangeError: minimumFractionDigits value is out of range.RangeError: maximumSignificantDigits value is out of range.
Cum o eviți pe viitor
- Când vrei un număr fix de zecimale, setează
minimumFractionDigitsșimaximumFractionDigitsla aceeași valoare. - Creează formatorii o dată, într-un singur loc (
formatLei,formatProcent). - Validează zecimalele venite din setări sau din formular.
- Testează formatorul în browserele țintă, inclusiv versiunile mai vechi, dacă folosești monede.
Întrebări frecvente
De ce toFixed(2) nu are problema asta?
toFixed are un singur parametru, deci nu există conflict între minim și maxim. Dar nu adaugă separatorul de mii și folosește mereu punctul zecimal; Intl.NumberFormat formatează după regulile limbii.
Ce înseamnă maximumSignificantDigits?
Limitează numărul total de cifre semnificative, nu doar zecimalele. Are propriul interval (1-21) și aceeași regulă: minimul nu poate depăși maximul.
Erori înrudite
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)`. 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: 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"`. Î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.
