Libical API Documentation
3.0
|
timezone handling routines More...
Go to the source code of this file.
Typedefs | |
typedef struct _icaltimezone | icaltimezone |
An opaque struct representing a timezone. We declare this here to avoid a circular dependancy. | |
timezone handling routines
void free_zone_directory | ( | void | ) |
Free memory dedicated to the zonefile directory
void icaltimezone_convert_time | ( | struct icaltimetype * | tt, |
icaltimezone * | from_zone, | ||
icaltimezone * | to_zone | ||
) |
int icaltimezone_dump_changes | ( | icaltimezone * | zone, |
int | max_year, | ||
FILE * | fp | ||
) |
Dumps information about changes in the timezone up to and including max_year.
This outputs a list of timezone changes for the given timezone to the given file, up to the maximum year given. We compare this output with the output from 'vzic –dump-changes' to make sure that we are consistent. (vzic is the Olson timezone database to VTIMEZONE converter.)
The output format is:
Zone-Name [tab] Date [tab] Time [tab] UTC-Offset
The Date and Time fields specify the time change in UTC.
The UTC Offset is for local (wall-clock) time. It is the amount of time to add to UTC to get local time.
void icaltimezone_free | ( | icaltimezone * | zone, |
int | free_struct | ||
) |
Frees all memory used for the icaltimezone. Set free_struct to free the icaltimezone struct as well.
Frees all memory used for the icaltimezone.
void icaltimezone_free_builtin_timezones | ( | void | ) |
Release builtin timezone memory
icaltimezone* icaltimezone_get_builtin_timezone | ( | const char * | location | ) |
Returns a single builtin timezone, given its Olson city name.
icaltimezone* icaltimezone_get_builtin_timezone_from_offset | ( | int | offset, |
const char * | tzname | ||
) |
Returns a single builtin timezone, given its offset.
Returns a single builtin timezone, given its offset from UTC
icaltimezone* icaltimezone_get_builtin_timezone_from_tzid | ( | const char * | tzid | ) |
Returns a single builtin timezone, given its TZID.
icalarray* icaltimezone_get_builtin_timezones | ( | void | ) |
Returns the array of builtin icaltimezones.
Returns an icalarray of icaltimezone structs, one for each builtin timezone. This will load and parse the zones.tab file to get the timezone names and their coordinates. It will not load the VTIMEZONE data for any timezones.
icalcomponent* icaltimezone_get_component | ( | icaltimezone * | zone | ) |
Returns the VTIMEZONE component of a timezone.
double icaltimezone_get_latitude | ( | icaltimezone * | zone | ) |
Returns the latitude of a builtin timezone.
const char* icaltimezone_get_location | ( | icaltimezone * | zone | ) |
Returns the city name of a timezone.
char* icaltimezone_get_location_from_vtimezone | ( | icalcomponent * | component | ) |
Gets the LOCATION or X-LIC-LOCATION property from a VTIMEZONE.
double icaltimezone_get_longitude | ( | icaltimezone * | zone | ) |
Returns the longitude of a builtin timezone.
const char* icaltimezone_get_tzid | ( | icaltimezone * | zone | ) |
Returns the TZID of a timezone.
const char* icaltimezone_get_tznames | ( | 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.
char* icaltimezone_get_tznames_from_vtimezone | ( | icalcomponent * | component | ) |
Gets the TZNAMEs used for the last STANDARD & DAYLIGHT components in a VTIMEZONE. If both STANDARD and DAYLIGHT components use the same TZNAME, it returns that. If they use different TZNAMEs, it formats them like "EST/EDT". The returned string should be freed by the caller.
int icaltimezone_get_utc_offset | ( | icaltimezone * | zone, |
struct icaltimetype * | tt, | ||
int * | is_daylight | ||
) |
int icaltimezone_get_utc_offset_of_utc_time | ( | 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.
icaltimezone* icaltimezone_get_utc_timezone | ( | void | ) |
Returns the UTC timezone.
Returns the special UTC timezone.
icaltimezone* icaltimezone_new | ( | void | ) |
Creates a new icaltimezone.
int icaltimezone_set_component | ( | icaltimezone * | zone, |
icalcomponent * | comp | ||
) |
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.
void icaltimezone_set_tzid_prefix | ( | const char * | new_prefix | ) |
Sets the prefix to be used for tzid's generated from system tzdata. 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 set_zone_directory | ( | const char * | path | ) |
Set the directory to look for the zonefiles