Function

ECalutil_time_to_zone

unstable since: 3.58

Declaration [src]

time_t
e_cal_util_time_to_zone (
  const ICalTime* itt,
  const gchar* tzid,
  ICalTimezone* to_zone,
  ICalComponent* vcalendar,
  ETimezoneCache* tz_cache,
  ICalTime** out_itt
)

Description [src]

Converts the itt in tzid to to_zone.

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

itt

Type: None

An ICalTime to convert.

The data is owned by the caller of the function.
tzid

Type: const gchar*

A timezone ID the itt is at, or NULL for floating time.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
to_zone

Type: None

No description available.

The data is owned by the caller of the function.
vcalendar

Type: None

An optional VCALENDAR component with timezones for the tzid, or NULL when not available.

The argument can be NULL.
The data is owned by the caller of the function.
tz_cache

Type: ETimezoneCache

An ETimezoneCache to use to read the time zones from, or NULL if not available.

The argument can be NULL.
The data is owned by the caller of the function.
out_itt

Type: None

Return location for the converted time as ICalTime, or NULL when 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.

Return value

Type: time_t

The time converted into to_zone, or -1, when the conversion was not possible.