lib/at.bitfire.ical4android.util/AndroidTimeUtils

AndroidTimeUtils

object AndroidTimeUtils

Properties

RECURRENCE_RULE_SEPARATOR

const val RECURRENCE_RULE_SEPARATOR: String

Used to separate multiple RRULEs/EXRULEs in the RRULE/EXRULE storage field.

TZID_ALLDAY

val TZID_ALLDAY: String

Timezone ID to store for all-day events, according to CalendarContract.Events SDK documentation.

Functions

androidifyTimeZone

fun androidifyTimeZone(dateList: DateListProperty)

Ensures that a given DateListProperty either

fun androidifyTimeZone(date: DateProperty?, tzRegistry: TimeZoneRegistry)

Ensures that a given DateProperty either

androidStringToRecurrenceSet

fun <T : DateListProperty> androidStringToRecurrenceSet(dbStr: String, tzRegistry: TimeZoneRegistry, allDay: Boolean, exclude: Long? = null, generator: (DateList) -> T): T

Takes a formatted string as provided by the Android calendar provider and returns a DateListProperty constructed from these values.

parseDuration

fun parseDuration(durationStr: String): TemporalAmount

Checks and fixes Event.duration values with incorrect format which can't be parsed by ical4j. Searches for values like "1H" and "3M" and groups them together in a standards-compliant way.

recurrenceSetsToAndroidString

fun recurrenceSetsToAndroidString(dates: List<DateListProperty>, dtStart: Date): String

Concatenates, if necessary, multiple RDATE/EXDATE lists and converts them to a formatted string which Android calendar provider can process.

recurrenceSetsToOpenTasksString

fun recurrenceSetsToOpenTasksString(dates: List<DateListProperty>, tz: TimeZone?): String

Concatenates, if necessary, multiple RDATE/EXDATE lists and converts them to a formatted string which OpenTasks can process. OpenTasks expect a list of RFC 5545 DATE ("yyyymmdd") or DATE-TIME ("yyyymmddZ") values, where the time zone is stored in a separate field.

storageTzId

fun storageTzId(date: DateProperty): String

Returns the time-zone ID for a given date or date-time that should be used to store it in the Android calendar provider.