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

RangeError: Invalid time zone specified: Europe/Bucuresti

Pe scurt

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 de Europe/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ă

Greșit
JavaScript
new Intl.DateTimeFormat("ro-RO", { timeZone: "Europe/Bucuresti" });
Corect
JavaScript
new Intl.DateTimeFormat("ro-RO", { timeZone: "Europe/Bucharest" });

Identificatorii IANA folosesc numele englezești ale orașelor.

2Abreviere în loc de identificator

Greșit
JavaScript
data.toLocaleString("ro-RO", { timeZone: "EET+2" });
Corect
JavaScript
data.toLocaleString("ro-RO", { timeZone: "Europe/Bucharest" });

Cu identificatorul orașului, trecerea la ora de vară se face automat.

3Spațiu în nume

Greșit
JavaScript
{ timeZone: "America/New York" }
Corect
JavaScript
{ timeZone: "America/New_York" }

Numele cu mai multe cuvinte folosesc _.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Ora în București: 12:00
Indiciu

Identificatorul IANA folosește numele englezesc al orașului.

Alte forme ale mesajului

  • RangeError: invalid time zone in DateTimeFormat(): EUROPE/BUCURESTI
  • RangeError: Invalid time zone specified: EET+2
  • RangeError: 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/catch câ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

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