gweather-timezone

gweather-timezone

Synopsis

                    GWeatherTimezone;
const char *        gweather_timezone_get_name          (GWeatherTimezone *zone);
const char *        gweather_timezone_get_tzid          (GWeatherTimezone *zone);
int                 gweather_timezone_get_offset        (GWeatherTimezone *zone);
gboolean            gweather_timezone_has_dst           (GWeatherTimezone *zone);
int                 gweather_timezone_get_dst_offset    (GWeatherTimezone *zone);
GWeatherTimezone *  gweather_timezone_ref               (GWeatherTimezone *zone);
void                gweather_timezone_unref             (GWeatherTimezone *zone);

Description

Details

GWeatherTimezone

typedef struct _GWeatherTimezone GWeatherTimezone;

A timezone.

There are no public methods for creating timezones; they can only be created by calling gweather_location_new_world() to parse Locations.xml, and then calling various GWeatherLocation methods to extract relevant timezones from the location hierarchy.


gweather_timezone_get_name ()

const char *        gweather_timezone_get_name          (GWeatherTimezone *zone);

Gets zone's name; a translated, user-presentable string.

Note that the returned name might not be unique among timezones, and may not make sense to the user unless it is presented along with the timezone's country's name (or in some context where the country is obvious).

zone :

a GWeatherTimezone

Returns :

zone's name

gweather_timezone_get_tzid ()

const char *        gweather_timezone_get_tzid          (GWeatherTimezone *zone);

Gets zone's tzdata identifier, eg "America/New_York".

zone :

a GWeatherTimezone

Returns :

zone's tzid

gweather_timezone_get_offset ()

int                 gweather_timezone_get_offset        (GWeatherTimezone *zone);

Gets zone's standard offset from UTC, in minutes. Eg, a value of 120 would indicate "GMT+2".

zone :

a GWeatherTimezone

Returns :

zone's standard offset, in minutes

gweather_timezone_has_dst ()

gboolean            gweather_timezone_has_dst           (GWeatherTimezone *zone);

Checks if zone observes daylight/summer time for part of the year.

zone :

a GWeatherTimezone

Returns :

TRUE if zone observes daylight/summer time.

gweather_timezone_get_dst_offset ()

int                 gweather_timezone_get_dst_offset    (GWeatherTimezone *zone);

Gets zone's daylight/summer time offset from UTC, in minutes. Eg, a value of 120 would indicate "GMT+2". This is only meaningful if gweather_timezone_has_dst() returns TRUE.

zone :

a GWeatherTimezone

Returns :

zone's daylight/summer time offset, in minutes

gweather_timezone_ref ()

GWeatherTimezone *  gweather_timezone_ref               (GWeatherTimezone *zone);

Adds 1 to zone's reference count.

zone :

a GWeatherTimezone

Returns :

zone

gweather_timezone_unref ()

void                gweather_timezone_unref             (GWeatherTimezone *zone);

Subtracts 1 from zone's reference count and frees it if it reaches 0.

zone :

a GWeatherTimezone