normalizedDate

fun DateProperty<*>.normalizedDate(): Temporal

Normalizes the date property to a system-compatible temporal representation.

Processes the underlying date or date-time of the DateProperty to ensure compatibility with content providers by converting ical4j-specific temporal types to system-known types:

  • Converts OffsetDateTime to Instant (UTC timestamp).

  • Converts ZonedDateTime with ical4j-based timezones to ZonedDateTime with system-known ZoneId.

  • Leaves Instant, LocalDate, and other temporal types unchanged.

Return

A normalized Temporal object: - Instant for UTC date-times (originally OffsetDateTime). - ZonedDateTime with system-known ZoneId for date-times with TZID. - Original Temporal type for other cases (Instant, LocalDate, etc.).