...
Eroare Kotlin · Biblioteca standard, Java și formatare

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

Pe scurt

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ă

Greșit
KOTLIN
val zona = ZoneId.of("Europe/Bucuresti")
Corect
KOTLIN
val zona = ZoneId.of("Europe/Bucharest")

ID-urile IANA folosesc numele în engleză ale orașelor.

2Spațiu în loc de underscore

Greșit
KOTLIN
val zona = ZoneId.of("America/New York")
Corect
KOTLIN
val zona = ZoneId.of("America/New_York")

În ID-uri, cuvintele din numele orașului se leagă cu _.

3Fus primit din date externe

Greșit
KOTLIN
val zona = ZoneId.of(setari.fus)
Corect
KOTLIN
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ă tu

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.

Codul care dă eroarea
KOTLIN
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()}")
}
După reparație, programul afișează
Ora la Bucuresti: 14:00
Indiciu

ID-ul IANA folosește numele englezesc al orașului: Europe/Bucharest.

Alte forme ale mesajului

  • Exception in thread "main" java.time.zone.ZoneRulesException: Unknown time-zone ID: Europe/Bucuresti
  • java.time.zone.ZoneRulesException: Unknown time-zone ID: America/New York
  • java.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

← Toate erorile Kotlin

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ță 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.