Function
ECalutil_property_time_to_zone
unstable since: 3.58
Declaration [src]
time_t
e_cal_util_property_time_to_zone (
ICalProperty* prop,
ICalTimezone* to_zone,
ICalComponent* vcalendar,
ETimezoneCache* tz_cache,
ICalTime** out_itt
)
Description [src]
Converts the time/date property prop to to_zone. When such property
does not contain DATE nor DATE-TIME value, 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).
Available since: 3.58
Parameters
prop-
Type:
NoneAn
ICalPropertyof DATE or DATE-TIME value.The data is owned by the caller of the function. 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
prop, 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.