ECal.util_time_to_zone
Description: Reference for ECal.util_time_to_zone

### Function

# ECalutil_time_to_zone

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.