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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Clasele din java.time conțin doar anumite câmpuri: LocalDate are an, lună, zi; LocalTime are oră, minut, secundă; LocalDateTime le are pe toate, iar Instant nu are deloc câmpuri calendaristice (fără fus orar). Când un DateTimeFormatter cere un câmp pe care obiectul nu-l are, primești UnsupportedTemporalTypeException: Unsupported field: HourOfDay.
Numele câmpului îți spune ce lipsește: HourOfDay (HH), MinuteOfHour (mm), ClockHourOfAmPm (hh), DayOfMonth (dd), YearOfEra (yyyy). Aceeași excepție apare și la date.get(ChronoField.HOUR_OF_DAY) sau la plus(1, ChronoUnit.HOURS) pe un LocalDate (Unsupported unit: Hours).
Caz frecvent: formatezi un Instant cu un model: lipsește fusul orar (Unsupported field: YearOfEra); adaugă .withZone(ZoneId.of("Europe/Bucharest")) formatter-ului.
De ce apare: cauzele frecvente
1LocalDate formatat cu oră
val f = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm")
println(LocalDate.now().format(f))val f = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm")
println(LocalDateTime.now().format(f))LocalDate nu are oră; LocalDateTime are și dată, și oră.
2Instant formatat fără fus orar
val f = DateTimeFormatter.ofPattern("dd.MM.yyyy")
println(f.format(Instant.now()))val f = DateTimeFormatter.ofPattern("dd.MM.yyyy").withZone(ZoneId.of("Europe/Bucharest"))
println(f.format(Instant.now()))Un Instant e un moment universal; ziua din calendar depinde de fusul orar, pe care trebuie să-l dai.
3Unitate de timp nepotrivită
val maine = LocalDate.now().plus(24, ChronoUnit.HOURS)val maine = LocalDate.now().plusDays(1)LocalDate lucrează în zile, nu în ore: mesajul aici este Unsupported unit: Hours.
Repară eroarea, direct în pagină
Programul afișează data și ora livrării, dar folosește un LocalDate, care nu are oră, și se oprește cu UnsupportedTemporalTypeException: Unsupported field: HourOfDay. Folosește LocalDateTime.of(2025, 3, 14, 9, 30) ca programul să afișeze Livrare: 14.03.2025 09:30.
import java.time.LocalDate
import java.time.format.DateTimeFormatter
fun main() {
val f = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm")
val livrare = LocalDate.of(2025, 3, 14)
println("Livrare: ${livrare.format(f)}")
}Livrare: 14.03.2025 09:30
Indiciu
Ai nevoie de un tip care are și dată, și oră: LocalDateTime.
Reparația
import java.time.LocalDateTime
import java.time.format.DateTimeFormatter
fun main() {
val f = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm")
val livrare = LocalDateTime.of(2025, 3, 14, 9, 30)
println("Livrare: ${livrare.format(f)}")
}De ce merge
Modelul HH:mm cere ora și minutul, dar un LocalDate conține doar anul, luna și ziua, așa că formatter-ul nu avea de unde să ia câmpul HourOfDay. LocalDateTime are toate câmpurile cerute de model. HH afișează ora pe două cifre (09), iar mm minutele (30).
Alte forme ale mesajului
Exception in thread "main" java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: HourOfDayjava.time.temporal.UnsupportedTemporalTypeException: Unsupported field: YearOfErajava.time.temporal.UnsupportedTemporalTypeException: Unsupported field: DayOfMonthjava.time.temporal.UnsupportedTemporalTypeException: Unsupported unit: Hours
Cum o eviți pe viitor
Alege tipul după ce reprezinți: LocalDate pentru zile (scadențe, zile de naștere), LocalDateTime pentru dată și oră locală, ZonedDateTime / Instant pentru momente exacte (log-uri, programări între fusuri). Ține formatter-ele ca constante lângă tipul pe care îl formatează și scrie un test mic pentru fiecare model. Pentru Instant, pune mereu fusul orar pe formatter.
Întrebări frecvente
De ce compilatorul nu mă avertizează?
Pentru că modelul este un simplu String, interpretat abia la rulare. Compilatorul nu știe ce câmpuri cere "HH:mm".
Care e diferența dintre HH și hh?
HH este ora 0-23 (HourOfDay), hh ora 1-12 (ClockHourOfAmPm), folosită împreună cu a (AM/PM). Pentru formatul românesc folosești HH.
Erori înrudite
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). 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.lang.IllegalArgumentException: Unknown pattern letter: b Modelul dat lui DateTimeFormatter.ofPattern conține o literă care nu înseamnă nimic pentru formatter (de exemplu b, sau un cuvânt scris direct). Textul fix din model se pune între apostrofuri: 'ora' sau 'T'. Verifică literele permise: d, M, y, H, m, s, E. Î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.
