...
Eroare Java · Date calendaristice și expresii regulate

java.time.zone.ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti

Pe scurt

Numele fusului orar dat lui ZoneId.of nu există în baza de date de fusuri a Java. Folosește ID-ul oficial, în engleză, de forma Continent/Oras: "Europe/Bucharest", "Europe/London", "UTC".

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Java folosește baza de date internațională de fusuri orare (IANA tz), în care fiecare fus are un ID de forma Continent/Oraș, cu numele orașului în engleză: Europe/Bucharest, Europe/Chisinau, America/New_York. Când ZoneId.of primește un ID care nu există, aruncă ZoneRulesException: Unknown time-zone ID și arată textul primit.

Greșelile tipice: numele orașului în română (Europe/Bucuresti), numele țării (Romania), abrevieri ambigue (EET, EEST, mai ales în forma prescurtată fără ZoneId.SHORT_IDS) sau spații și litere în plus. Dacă textul nu are nici măcar formatul corect (de exemplu conține un spațiu), mesajul este DateTimeException: Invalid ID for region-based ZoneId.

Lista completă o obții cu ZoneId.getAvailableZoneIds(). Pentru România, ID-ul este Europe/Bucharest; el se ocupă singur și de ora de vară.

De ce apare: cauzele frecvente

1Numele orașului în română

Greșit
JAVA
ZoneId z = ZoneId.of("Europe/Bucuresti");
Corect
JAVA
ZoneId z = ZoneId.of("Europe/Bucharest");

ID-urile folosesc numele englezești ale orașelor.

2Numele țării în loc de ID

Greșit
JAVA
ZoneId z = ZoneId.of("Romania");
Corect
JAVA
ZoneId z = ZoneId.of("Europe/Bucharest");

Fusurile se identifică după un oraș reprezentativ, nu după țară.

3Offset fix în loc de fus cu oră de vară

Greșit
JAVA
ZoneId z = ZoneId.of("GMT+2 ");
Corect
JAVA
ZoneId z = ZoneId.of("Europe/Bucharest");
// sau, offset fix fără oră de vară: ZoneOffset.ofHours(2)

Un offset fix nu se schimbă vara. Europe/Bucharest aplică automat +2 iarna și +3 vara.

Repară tu

Repară eroarea, direct în pagină

Programul convertește ora unui webinar din UTC în ora României, dar se oprește cu ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti. Folosește ID-ul corect al fusului, ca programul să afișeze Webinar la Bucuresti: 15:00.

Codul care dă eroarea
JAVA
import java.time.*;

public class Main {
    public static void main(String[] args) {
        ZonedDateTime utc = LocalDateTime.of(2024, 7, 1, 12, 0).atZone(ZoneId.of("UTC"));
        ZonedDateTime ro = utc.withZoneSameInstant(ZoneId.of("Europe/Bucuresti"));
        System.out.println("Webinar la Bucuresti: " + ro.toLocalTime());
    }
}
După reparație, programul afișează
Webinar la Bucuresti: 15:00
Indiciu

ID-urile de fus folosesc numele orașului în engleză.

Alte forme ale mesajului

  • java.time.zone.ZoneRulesException: Unknown time-zone ID: Romania
  • java.time.DateTimeException: Invalid ID for region-based ZoneId, invalid format: Europe/ Bucharest
  • java.time.zone.ZoneRulesException: Unknown time-zone ID: EET+2

Cum o eviți pe viitor

  • Ține ID-urile de fus în constante: static final ZoneId RO = ZoneId.of("Europe/Bucharest");.
  • Validează ID-urile primite din exterior cu ZoneId.getAvailableZoneIds().contains(id).
  • Stochează momentele în UTC (Instant) și convertește la fusul utilizatorului doar la afișare.
  • Evită abrevierile de 3 litere (EET, CET): sunt ambigue și nu toate sunt acceptate.

Întrebări frecvente

Europe/Bucharest ține cont de ora de vară?

Da. Regulile fusului includ trecerea la ora de vară și înapoi, deci aceeași oră UTC devine 14:00 iarna și 15:00 vara la București.

De ce pe server ora e diferită față de laptopul meu?

Probabil serverul rulează în UTC, iar codul folosește ZoneId.systemDefault(). Specifică explicit fusul dorit, în loc să te bazezi pe setarea calculatorului.

Erori înrudite

← Toate erorile Java

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ță Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.