Top |
ICalTimezone *
i_cal_timezone_new (void
);
The constructor of the type ICalTimezone.
Since: 1.0
ICalTimezone *
i_cal_timezone_copy (const ICalTimezone *zone
);
The clone method for ICalTimezone.
Since: 1.0
void i_cal_timezone_free (ICalTimezone *zone
,gint free_struct
);
The destructor of ICalTimezone.
[skip]
zone |
The ICalTimezone to be freed |
|
free_struct |
Whether to free it or reset it. 1 to free and 0 to reset |
Since: 1.0
void
i_cal_timezone_set_tzid_prefix (const gchar *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.
Since: 1.0
void
i_cal_timezone_free_builtin_timezones (void
);
Frees any builtin timezone information.
Since: 1.0
ICalTimezone *
i_cal_timezone_get_builtin_timezone (const gchar *location
);
Returns a single builtin timezone, given its Olson city name.
Since: 1.0
ICalTimezone * i_cal_timezone_get_builtin_timezone_from_offset (gint offset
,const gchar *tzname
);
Returns a single builtin timezone, given its offset.
offset |
The offset used to get the ICalTimezone |
|
tzname |
The reference ICalTimezone name. |
[nullable] |
Since: 1.0
ICalTimezone *
i_cal_timezone_get_builtin_timezone_from_tzid
(const gchar *tzid
);
Returns a single builtin timezone, given its TZID.
Since: 1.0
ICalArray *
i_cal_timezone_get_builtin_timezones (void
);
Returns a list of builtin timezones.
Since: 1.0
ICalTimezone *
i_cal_timezone_get_utc_timezone (void
);
Returns the UTC timezone.
Since: 1.0
const gchar *
i_cal_timezone_get_tzid (const ICalTimezone *zone
);
Returns the TZID of a timezone, or NULL
, when none is set or when zone
is also NULL
.
Since: 1.0
const gchar *
i_cal_timezone_get_location (const ICalTimezone *zone
);
Returns the city name of a timezone, or NULL
, when none is set or when zone
is also NULL
.
Since: 1.0
const gchar *
i_cal_timezone_get_tznames (const 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.
Since: 1.0
gdouble
i_cal_timezone_get_latitude (const ICalTimezone *zone
);
Returns the latitude of a builtin timezone.
Since: 1.0
gdouble
i_cal_timezone_get_longitude (const ICalTimezone *zone
);
Returns the longitude of a builtin timezone.
Since: 1.0
ICalComponent *
i_cal_timezone_get_component (const ICalTimezone *zone
);
Returns the VTIMEZONE component of a timezone.
Since: 1.0
gint i_cal_timezone_set_component (ICalTimezone *zone
,ICalComponent *comp
);
Sets the VTIMEZONE component of ICalTimezone, initializing the tzid, location and tzname fields. It returns 1 on success or 0 on failure, i.e. no TZID was found.
note
The zone
assumes ownership
of the comp
, thus make sure you pass an unowned ICalComponent.
zone |
The ICalTimezone to be set |
|
comp |
The VTIMEZONE component of an ICalTimezone, initializing the tzid, location and tzname fields |
Since: 1.0
const gchar *
i_cal_timezone_get_display_name (const ICalTimezone *zone
);
Gets the display name of the zone
.
Since: 1.0
void i_cal_time_convert_timezone (ICalTime *tt
,ICalTimezone *from_zone
,ICalTimezone *to_zone
);
Convert time from one timezone to another.
tt |
The time to be converted |
|
from_zone |
From timezone. |
[nullable] |
to_zone |
To timezone. |
[nullable] |
Since: 1.0
gint i_cal_timezone_get_utc_offset (ICalTimezone *zone
,ICalTime *tt
,gint *is_daylight
);
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.
zone |
The given ICalTimezone. |
[nullable] |
tt |
The local time. |
[nullable] |
is_daylight |
Whether it is day light. |
[out][optional] |
Since: 1.0
gint i_cal_timezone_get_utc_offset_of_utc_time (ICalTimezone *zone
,ICalTime *tt
,gint *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.
zone |
The given ICalTimezone. |
[nullable] |
tt |
The local time |
|
is_daylight |
Whether it is day light, can be |
[out][optional] |
Since: 1.0
ICalArray *
i_cal_timezone_array_new (void
);
Creates a new array of timezones.
Since: 1.0
void i_cal_timezone_array_append_from_vtimezone (ICalArray *timezones
,ICalComponent *child
);
Populate the array of timezones with a component.
note
The timezones
assumes ownership of the
child
, thus make sure you pass an unowned ICalComponent.
Since: 1.0
void
i_cal_timezone_array_free (ICalArray *timezones
);
Frees an array of timezones.
[skip]
Since: 1.0
void i_cal_time_timezone_expand_vtimezone (ICalComponent *comp
,gint end_year
,ICalArray *changes
);
Applies a list of timezone changes on the array of components until the end year.
Since: 2.0
gchar *
i_cal_timezone_get_location_from_vtimezone
(ICalComponent *component
);
Gets the location of the vtimezone in component.
Since: 2.0
gchar *
i_cal_timezone_get_tznames_from_vtimezone
(ICalComponent *component
);
Gets the name of the vtimezone in component.
Since: 2.0
const gchar *
i_cal_timezone_get_zone_directory (void
);
Gets the directory to look for the zonefiles.
Since: 3.0.17
void
i_cal_timezone_set_zone_directory (const gchar *path
);
Sets the directory to look for the zonefiles.
Since: 1.0
void
i_cal_timezone_free_zone_directory (void
);
Frees memory dedicated to the zonefile directory.
Since: 1.0
void
i_cal_timezone_release_zone_tab (void
);
Frees memory dedicated to the zonefile directory.
Since: 1.0
void
i_cal_timezone_set_builtin_tzdata (gboolean set
);
Sets whether to use builtin timezones files.
Since: 2.0
gboolean
i_cal_timezone_get_builtin_tzdata (void
);
Gets whether to use builtin timezones files.
Since: 2.0
gint i_cal_timezone_dump_changes (ICalTimezone *zone
,gint max_year
,FILE *fp
);
Outputs a list of timezone changes for the given timezone to the given file, up to the maximum year given.
Since: 1.0
ICalTimezone * i_cal_timezone_array_element_at (ICalArray *timezones
,guint index
);
Gets the ICalTimezone at specified position in array.
Since: 1.0