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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Intl.DateTimeFormat (și toLocaleString, toLocaleDateString, toLocaleTimeString) poate afișa o dată în orice fus orar prin opțiunea timeZone. Valoarea trebuie să fie un identificator din baza de date IANA (Regiune/Oraș, cu numele orașului în engleză) sau "UTC", ori un decalaj fix ca "+02:00" în motoarele recente. Dacă motorul nu recunoaște numele, aruncă această RangeError, cu valoarea primită la final.
Greșeli tipice:
- orașul scris în română:
Europe/Bucurestiîn loc deEurope/Bucharest; - abrevieri ca
EET,EEST,CET+1, care nu sunt identificatori valizi; - spații în loc de
_:America/New York; - un fus orar luat din setările utilizatorului sau dintr-o bază de date fără validare.
Fusul orar al utilizatorului îl obții cu Intl.DateTimeFormat().resolvedOptions().timeZone, iar lista completă cu Intl.supportedValuesOf("timeZone").
De ce apare: cauzele frecvente
1Numele orașului în română
new Intl.DateTimeFormat("ro-RO", { timeZone: "Europe/Bucuresti" });new Intl.DateTimeFormat("ro-RO", { timeZone: "Europe/Bucharest" });Identificatorii IANA folosesc numele englezești ale orașelor.
2Abreviere în loc de identificator
data.toLocaleString("ro-RO", { timeZone: "EET+2" });data.toLocaleString("ro-RO", { timeZone: "Europe/Bucharest" });Cu identificatorul orașului, trecerea la ora de vară se face automat.
3Spațiu în nume
{ timeZone: "America/New York" }{ timeZone: "America/New_York" }Numele cu mai multe cuvinte folosesc _.
Repară eroarea, direct în pagină
Programul afișează ora unui webinar (programat la 10:00 UTC) pentru participanții din România, dar se oprește cu RangeError: Invalid time zone specified: Europe/Bucuresti. Repară fusul orar ca programul să afișeze Ora în București: 12:00.
const webinar = new Date(Date.UTC(2024, 0, 15, 10, 0));
const ora = new Intl.DateTimeFormat("ro-RO", {
timeZone: "Europe/Bucuresti",
hour: "2-digit",
minute: "2-digit",
hourCycle: "h23",
}).format(webinar);
console.log(`Ora în București: ${ora}`);Ora în București: 12:00
Indiciu
Identificatorul IANA folosește numele englezesc al orașului.
Reparația
const webinar = new Date(Date.UTC(2024, 0, 15, 10, 0));
const ora = new Intl.DateTimeFormat("ro-RO", {
timeZone: "Europe/Bucharest",
hour: "2-digit",
minute: "2-digit",
hourCycle: "h23",
}).format(webinar);
console.log(`Ora în București: ${ora}`);De ce merge
Intl.DateTimeFormat recunoaște doar fusurile orare din baza de date IANA, cu nume de orașe în engleză, așa că Europe/Bucuresti a fost respins. Europe/Bucharest e identificatorul corect. În ianuarie România e la UTC+2 (ora de iarnă), deci 10:00 UTC se afișează 12:00. Vara, același identificator aplică automat UTC+3.
Alte forme ale mesajului
RangeError: invalid time zone in DateTimeFormat(): EUROPE/BUCURESTIRangeError: Invalid time zone specified: EET+2RangeError: Invalid time zone specified: undefined
Cum o eviți pe viitor
- Salvează în date identificatorul IANA (
Europe/Bucharest), nu abrevieri sau decalaje. - Alege fusul dintr-o listă (
Intl.supportedValuesOf("timeZone")), nu dintr-un câmp liber. - Păstrează datele în UTC și convertește doar la afișare.
- Prinde eroarea cu
try/catchcând fusul vine din exterior și folosește UTC ca rezervă.
Întrebări frecvente
De ce primesc Invalid time zone specified: undefined?
Ai transmis textul "undefined", de exemplu dintr-un template literal cu o variabilă lipsă (${setari.fus}). Dacă opțiunea timeZone lipsește sau are chiar valoarea undefined, se folosește fusul local, fără eroare.
Pot folosi "+02:00"?
În versiunile recente de Chrome, Firefox și Node, da. Dar un decalaj fix nu ține cont de ora de vară, deci pentru România e mai corect Europe/Bucharest.
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: 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. Î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.
