1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 Must be globally unique (such as a domain name owned by the developer of the calling application), and begin and end with forward slashes. Do not change or de-allocate the string buffer after calling this. */ void icaltimezone_set_tzid_prefix(const char *new_prefix); /** * @par Accessing timezones. */ /** Free any builtin timezone information **/ void icaltimezone_free_builtin_timezones(void); /** Returns the array of builtin icaltimezones. */ icalarray* icaltimezone_get_builtin_timezones (void); /** Returns a single builtin timezone, given its Olson city name. */ icaltimezone* icaltimezone_get_builtin_timezone (const char *location); /** Returns a single builtin timezone, given its offset. */ icaltimezone* icaltimezone_get_builtin_timezone_from_offset (int offset, const char *tzname); /** Returns a single builtin timezone, given its TZID. */ icaltimezone* icaltimezone_get_builtin_timezone_from_tzid (const char *tzid); /** Returns the UTC timezone. */ icaltimezone* icaltimezone_get_utc_timezone (void); /** Returns the TZID of a timezone. */ const char* icaltimezone_get_tzid (icaltimezone *zone); /** Returns the city name of a timezone. */ const char* icaltimezone_get_location (icaltimezone *zone); /** Returns the TZNAME properties used in the latest STANDARD and DAYLIGHT components. If they are the same it will return just one, e.g. "LMT". If they are different it will format them like "EST/EDT". Note that this may also return NULL. */ const char* icaltimezone_get_tznames (icaltimezone *zone); /** Returns the latitude of a builtin timezone. */ double icaltimezone_get_latitude (icaltimezone *zone); /** Returns the longitude of a builtin timezone. */ double icaltimezone_get_longitude (icaltimezone *zone); /** Returns the VTIMEZONE component of a timezone. */ icalcomponent* icaltimezone_get_component (icaltimezone *zone); /** Sets the VTIMEZONE component of an icaltimezone, initializing the tzid, location & tzname fields. It returns 1 on success or 0 on failure, i.e. no TZID was found. */ int icaltimezone_set_component (icaltimezone *zone, icalcomponent *comp); const char* icaltimezone_get_display_name (icaltimezone *zone); /** * @par Converting times between timezones. */ void icaltimezone_convert_time (struct icaltimetype *tt, icaltimezone *from_zone, icaltimezone *to_zone); /** * @par Getting offsets from UTC. */ /** Calculates the UTC offset of a given local time in the given timezone. It is the number of seconds to add to UTC to get local time. The is_daylight flag is set to 1 if the time is in daylight-savings time. */ int icaltimezone_get_utc_offset (icaltimezone *zone, struct icaltimetype *tt, int *is_daylight); /** Calculates the UTC offset of a given UTC time in the given timezone. It is the number of seconds to add to UTC to get local time. The is_daylight flag is set to 1 if the time is in daylight-savings time. */ int icaltimezone_get_utc_offset_of_utc_time (icaltimezone *zone, struct icaltimetype *tt, int *is_daylight); /* * Handling arrays of timezones. Mainly for internal use. */ icalarray* icaltimezone_array_new (void); void icaltimezone_array_append_from_vtimezone (icalarray *timezones, icalcomponent *child); void icaltimezone_array_free (icalarray *timezones); /* * @par Handling the default location the timezone files */ /** Set the directory to look for the zonefiles */ void set_zone_directory(char *path); /** Free memory dedicated to the zonefile directory */ void free_zone_directory(void); void icaltimezone_release_zone_tab(void); /* * @par Debugging Output. */ /** Dumps information about changes in the timezone up to and including max_year. */ int icaltimezone_dump_changes (icaltimezone *zone, int max_year, FILE *fp); #endif /* ICALTIMEZONE_H */