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

java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: HourOfDay

Pe scurt

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ă

Greșit
KOTLIN
val f = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm")
println(LocalDate.now().format(f))
Corect
KOTLIN
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

Greșit
KOTLIN
val f = DateTimeFormatter.ofPattern("dd.MM.yyyy")
println(f.format(Instant.now()))
Corect
KOTLIN
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ă

Greșit
KOTLIN
val maine = LocalDate.now().plus(24, ChronoUnit.HOURS)
Corect
KOTLIN
val maine = LocalDate.now().plusDays(1)

LocalDate lucrează în zile, nu în ore: mesajul aici este Unsupported unit: Hours.

Repară tu

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.

Codul care dă eroarea
KOTLIN
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)}")
}
După reparație, programul afișează
Livrare: 14.03.2025 09:30
Indiciu

Ai nevoie de un tip care are și dată, și oră: LocalDateTime.

Alte forme ale mesajului

  • Exception in thread "main" java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: HourOfDay
  • java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: YearOfEra
  • java.time.temporal.UnsupportedTemporalTypeException: Unsupported field: DayOfMonth
  • java.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

← 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.