java.time.zone.ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti
Ai dat lui ZoneId.of un nume de fus orar care nu există în baza de date IANA. Numele corecte sunt în engleză, de forma Continent/Oraș: Europe/Bucharest, Europe/London, America/New_York. Verifică ortografia sau folosește un offset fix (ZoneOffset.ofHours(2)).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fusurile orare din java.time vin din baza de date IANA (tz database), cu nume standard de forma Regiune/Oraș, în engleză: Europe/Bucharest, Europe/Paris, Asia/Tokyo. ZoneId.of("...") caută exact numele dat; dacă nu-l găsește, aruncă ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti.
Cauze tipice: nume traduse sau scrise după ureche (Europe/Bucuresti), litere mari/mici greșite, spații în loc de _ (America/New York), abrevieri ambigue (EET, EST merg doar parțial sau nu fac ce crezi) sau nume primite de la alt sistem.
Dacă textul nu are deloc forma unui ID (de exemplu un string gol sau +2), mesajul este altul: DateTimeException: Invalid ID for region-based ZoneId sau Invalid ID for ZoneOffset.
De ce apare: cauzele frecvente
1Numele orașului în română
val zona = ZoneId.of("Europe/Bucuresti")val zona = ZoneId.of("Europe/Bucharest")ID-urile IANA folosesc numele în engleză ale orașelor.
2Spațiu în loc de underscore
val zona = ZoneId.of("America/New York")val zona = ZoneId.of("America/New_York")În ID-uri, cuvintele din numele orașului se leagă cu _.
3Fus primit din date externe
val zona = ZoneId.of(setari.fus)val zona = if (setari.fus in ZoneId.getAvailableZoneIds()) ZoneId.of(setari.fus)
else ZoneId.of("UTC")getAvailableZoneIds() conține toate ID-urile valide; verifică înainte când valoarea vine din afară.
Repară eroarea, direct în pagină
Programul afișează ora unei întâlniri în fusul orar al Bucureștiului, dar ID-ul fusului e scris în română și programul se oprește cu ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti. Corectează ID-ul ca programul să afișeze Ora la Bucuresti: 14:00.
import java.time.*
fun main() {
val intalnire = ZonedDateTime.of(2025, 6, 10, 11, 0, 0, 0, ZoneId.of("UTC"))
val local = intalnire.withZoneSameInstant(ZoneId.of("Europe/Bucuresti"))
println("Ora la Bucuresti: ${local.toLocalTime()}")
}Ora la Bucuresti: 14:00
Indiciu
ID-ul IANA folosește numele englezesc al orașului: Europe/Bucharest.
Reparația
import java.time.*
fun main() {
val intalnire = ZonedDateTime.of(2025, 6, 10, 11, 0, 0, 0, ZoneId.of("UTC"))
val local = intalnire.withZoneSameInstant(ZoneId.of("Europe/Bucharest"))
println("Ora la Bucuresti: ${local.toLocalTime()}")
}De ce merge
ZoneId.of caută numele exact în baza de date IANA a fusurilor orare, unde orașele au nume englezești: Europe/Bucharest. Cu ID-ul corect, withZoneSameInstant mută momentul 11:00 UTC în fusul României. Pe 10 iunie se aplică ora de vară (+03:00), de aceea rezultatul este 14:00, nu 13:00.
Alte forme ale mesajului
Exception in thread "main" java.time.zone.ZoneRulesException: Unknown time-zone ID: Europe/Bucurestijava.time.zone.ZoneRulesException: Unknown time-zone ID: America/New Yorkjava.time.DateTimeException: Invalid ID for region-based ZoneId, invalid format: Europe/
Cum o eviți pe viitor
Nu scrie ID-urile de fus din memorie: copiază-le din lista oficială sau din ZoneId.getAvailableZoneIds(). Ține fusurile folosite des ca constante (val BUCURESTI = ZoneId.of("Europe/Bucharest")). Salvează în baza de date momentele în UTC (Instant) și convertește la fusul utilizatorului doar la afișare. Când primești fusul de la client, validează-l și folosește o valoare implicită.
Întrebări frecvente
De ce nu folosesc direct +02:00?
Pentru că România are +02:00 iarna și +03:00 vara. Un ID ca Europe/Bucharest aplică automat ora de vară; un offset fix (ZoneOffset.ofHours(2)) nu.
Cum aflu fusul sistemului?
ZoneId.systemDefault(). Pe servere este adesea UTC, așa că nu te baza pe el pentru ora afișată utilizatorilor.
Erori înrudite
java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: HourOfDay Ai formatat o dată fără oră (LocalDate) cu un model care cere ora (HH:mm), sau o oră (LocalTime) cu un model care cere ziua. Folosește tipul potrivit (LocalDateTime pentru dată și oră) sau scoate din model câmpurile care nu există. java.time.DateTimeException: Invalid date 'FEBRUARY 30' Ai creat o dată care nu există în calendar: 30 februarie, 31 aprilie, 29 februarie într-un an nebisect. LocalDate.of verifică ziua. Pentru calcule pornește de la o dată validă și folosește plusDays/plusMonths sau withDayOfMonth(luna.lengthOfMonth()) pentru ultima zi. java.time.format.DateTimeParseException: Text '01.03.2024' could not be parsed at index 0 Textul datei nu are formatul așteptat. LocalDate.parse(text) acceptă doar formatul ISO, 2024-03-01. Pentru 01.03.2024 dă un formatter: LocalDate.parse(text, DateTimeFormatter.ofPattern("dd.MM.yyyy")). Dacă formatul e bun, verifică valorile (luna 13, ziua 31 februarie). Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
