java.time.zone.ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti
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ă
ZoneId z = ZoneId.of("Europe/Bucuresti");ZoneId z = ZoneId.of("Europe/Bucharest");ID-urile folosesc numele englezești ale orașelor.
2Numele țării în loc de ID
ZoneId z = ZoneId.of("Romania");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ă
ZoneId z = ZoneId.of("GMT+2 ");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ă 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.
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());
}
}Webinar la Bucuresti: 15:00
Indiciu
ID-urile de fus folosesc numele orașului în engleză.
Reparația
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/Bucharest"));
System.out.println("Webinar la Bucuresti: " + ro.toLocalTime());
}
}De ce merge
Baza de date de fusuri orare folosește ID-uri în engleză, iar Europe/Bucuresti nu există în ea. Europe/Bucharest este fusul României, cu regulile de oră de vară incluse. Pe 1 iulie România e la UTC+3, deci ora 12:00 UTC devine 15:00 la București.
Alte forme ale mesajului
java.time.zone.ZoneRulesException: Unknown time-zone ID: Romaniajava.time.DateTimeException: Invalid ID for region-based ZoneId, invalid format: Europe/ Bucharestjava.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
java.time.DateTimeException: Invalid date 'FEBRUARY 30' Ai construit o dată care nu există în calendar: 30 februarie, 31 aprilie sau 29 februarie într-un an nebisect. Verifică ziua față de lungimea lunii (YearMonth.lengthOfMonth()) sau calculează datele cu plusDays / plusMonths în loc să le compui de mână. java.time.format.DateTimeParseException: Text '01.02.2024' could not be parsed at index 0 LocalDate.parse (sau LocalDateTime.parse) a primit o dată în alt format decât cel așteptat. Fără formatter, Java acceptă doar formatul ISO: 2024-02-01 (și 2024-02-01T10:30 pentru dată cu oră). Pentru 01.02.2024 folosește DateTimeFormatter.ofPattern("dd.MM.yyyy"). java.time.temporal.UnsupportedTemporalTypeException: Unsupported unit: Seconds Ai cerut unui tip de dată o unitate sau un câmp pe care nu-l are: Duration.between pe două LocalDate (fără ore), plus(ore) pe o LocalDate sau HH în formatul unei LocalDate. Folosește ChronoUnit.DAYS.between(a, b) sau Period, ori lucrează cu LocalDateTime. Î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.
