Function
ECalutil_comp_time_to_zone
unstable since: 3.58
Declaration [src]
time_t
e_cal_util_comp_time_to_zone (
ICalComponent* icomp,
ICalPropertyKind prop_kind,
ICalTimezone* to_zone,
ICalComponent* vcalendar,
ETimezoneCache* tz_cache,
ICalTime** out_itt
)
Description [src]
Converts the time/date property prop_kind to to_zone. When such property
does not exist, or does not contain DATE nor DATE-TIME value, then
the function returns -1 and no output argument is set.
The vcalendar is used to get the timezone for the property, if provided,
otherwise the timezone is tried to be found in the tz_cache. If neither
can get it, the iCal builtin timezones are checked. When the set timezone
cannot be found, floating time is used (which can be almost always wrong).
Note: this uses i_cal_component_get_first_property(), thus it cannot be used in case any upper caller uses it too at the same time.
Available since: 3.58
Parameters
icomp-
Type:
NoneAn
ICalComponentto get the property from.The data is owned by the caller of the function. prop_kind-
Type:
ICalPropertyKindAn
ICalPropertyKindof the property to read. to_zone-
Type:
NoneAn
ICalTimezoneto convert the time to, orNULLfor UTC.The argument can be NULL.The data is owned by the caller of the function. vcalendar-
Type:
NoneAn optional VCALENDAR component with timezones for the
icomp, orNULLwhen not available.The argument can be NULL.The data is owned by the caller of the function. tz_cache-
Type:
ETimezoneCacheAn
ETimezoneCacheto use to read the time zones from, orNULLif not available.The argument can be NULL.The data is owned by the caller of the function. out_itt-
Type:
NoneReturn location for the converted time as
ICalTime, orNULLwhen not requested.The argument will be set by the function. The argument can be NULL.The caller of the function takes ownership of the returned data, and is responsible for freeing it.