GTimeZoneGTimeZone — a structure representing a time zone |
Open the Activities overview and start typing Settings. Click on Settings. Click Date & Time in the sidebar to open the panel. If you have the Automatic Time Zone switch set to on, your time zone should update automatically if you have an internet connection and the location services feature is enabled. To update your time zone manually, set this to off. Bella Haus Design Peeing Gnome - 10.3' Tall Polyresin - Naughty Garden Gnome for Lawn Ornaments, Indoor or Outdoor Decorations - Red and Green Funny Flashing Gnomes 4.3 out of 5 stars 635 $29.95.
Functions
void | g_time_zone_unref() |
GTimeZone * | g_time_zone_ref() |
GTimeZone * | g_time_zone_new() |
GTimeZone * | g_time_zone_new_local() |
GTimeZone * | g_time_zone_new_utc() |
GTimeZone * | g_time_zone_new_offset() |
gint | g_time_zone_find_interval() |
gint | g_time_zone_adjust_time() |
const gchar * | g_time_zone_get_identifier() |
const gchar * | g_time_zone_get_abbreviation() |
gint32 | g_time_zone_get_offset() |
gboolean | g_time_zone_is_dst() |
Types and Values
Includes
Description
GTimeZone is a structure that represents a time zone, at noparticular point in time. It is refcounted and immutable.
Each time zone has an identifier (for example, ‘Europe/London’) which isplatform dependent. See g_time_zone_new()
for information on the identifierformats. The identifier of a time zone can be retrieved usingg_time_zone_get_identifier()
.
A time zone contains a number of intervals. Each interval hasan abbreviation to describe it (for example, ‘PDT’), an offset to UTC and aflag indicating if the daylight savings time is in effect during thatinterval. A time zone always has at least one interval — interval 0. Notethat interval abbreviations are not the same as time zone identifiers(apart from ‘UTC’), and cannot be passed to g_time_zone_new()
.
Every UTC time is contained within exactly one interval, but a givenlocal time may be contained within zero, one or two intervals (due toincontinuities associated with daylight savings time).
An interval may refer to a specific period of time (eg: the durationof daylight savings time during 2010) or it may refer to many periodsof time that share the same properties (eg: all periods of daylightsavings time). It is also possible (usually for political reasons)that some properties (like the abbreviation) change between intervalswithout other properties changing.
GTimeZone is available since GLib 2.26.
Functions
g_time_zone_unref ()
Decreases the reference count on tz
.
Parameters
Since: 2.26
g_time_zone_ref ()
Increases the reference count on tz
.
Parameters
Returns
a new reference to tz
.
Since: 2.26
g_time_zone_new ()
Creates a GTimeZone corresponding to identifier
.
identifier
can either be an RFC3339/ISO 8601 time offset orsomething that would pass as a valid value for the TZ
environmentvariable (including NULL
).
In Windows, identifier
can also be the unlocalized name of a timezone for standard time, for example 'Pacific Standard Time'.
Valid RFC3339 time offsets are 'Z'
(for UTC) or'±hh:mm'
. ISO 8601 additionally specifies'±hhmm'
and '±hh'
. Offsets aretime values to be added to Coordinated Universal Time (UTC) to getthe local time.
In UNIX, the TZ
environment variable typically correspondsto the name of a file in the zoneinfo database, an absolute path to a filesomewhere else, or a string in'std offset [dst [offset],start[/time],end[/time]]' (POSIX) format.There are no spaces in the specification. The name of standardand daylight savings time zone must be three or more alphabeticcharacters. Offsets are time values to be added to local time toget Coordinated Universal Time (UTC) and should be'[±]hh[[:]mm[:ss]]'
. Dates are either'Jn'
(Julian day with n between 1 and 365, leapyears not counted), 'n'
(zero-based Julian daywith n between 0 and 365) or 'Mm.w.d'
(day d(0 <= d <= 6) of week w (1 <= w <= 5) of month m (1 <= m <= 12), day0 is a Sunday). Times are in local wall clock time, the default is02:00:00.
In Windows, the 'tzn[+ –]hh[:mm[:ss]][dzn]' format is used, but alsoaccepts POSIX format. The Windows format uses US rules for all timezones; daylight savings time is 60 minutes behind the standard timewith date and time of change taken from Pacific Standard Time.Offsets are time values to be added to the local time to getCoordinated Universal Time (UTC).
g_time_zone_new_local() calls this function with the value of theTZ
environment variable. This function itself is independent ofthe value of TZ
, but if identifier
is NULL
then /etc/localtime
will be consulted to discover the correct time zone on UNIX and theregistry will be consulted or GetTimeZoneInformation()
will be usedto get the local time zone on Windows.
If intervals are not available, only time zone rules from TZ
environment variable or other means, then they will be computedfrom year 1900 to 2037. If the maximum year for the rules isavailable and it is greater than 2037, then it will followedinstead.
SeeRFC3339 §5.6for a precise definition of valid RFC3339 time offsets(the time-offset
expansion) and ISO 8601 for thefull list of valid time offsets. SeeThe GNU C Library manualfor an explanation of the possiblevalues of the TZ
environment variable. SeeMicrosoft Time Zone Index Valuesfor the list of time zones on Windows.
You should release the return value by calling g_time_zone_unref()
when you are done with it.
Parameters
Returns
the requested timezone
Since: 2.26
g_time_zone_new_local ()
Creates a GTimeZone corresponding to local time. The local timezone may change between invocations to this function; for example,if the system administrator changes it.
This is equivalent to calling g_time_zone_new()
with the value ofthe TZ
environment variable (including the possibility of NULL
).
You should release the return value by calling g_time_zone_unref()
when you are done with it.
Since: 2.26
Psu Gnome Zone
g_time_zone_new_utc ()
Creates a GTimeZone corresponding to UTC.
This is equivalent to calling g_time_zone_new()
with a value like'Z', 'UTC', '+00', etc.
You should release the return value by calling g_time_zone_unref()
when you are done with it.
Since: 2.26
g_time_zone_new_offset ()
Creates a GTimeZone corresponding to the given constant offset from UTC,in seconds.
This is equivalent to calling g_time_zone_new()
with a string in the form[+ -]hh[:mm[:ss]]
.
Parameters
Returns
a timezone at the given offset from UTC.
[transfer full]
Since: 2.58
g_time_zone_find_interval ()
Finds an interval within tz
that corresponds to the given time_
.The meaning of time_
depends on type
.
If type
is G_TIME_TYPE_UNIVERSAL
then this function will alwayssucceed (since universal time is monotonic and continuous).
Otherwise time_
is treated as local time. The distinction betweenG_TIME_TYPE_STANDARD
and G_TIME_TYPE_DAYLIGHT
is ignored except inthe case that the given time_
is ambiguous. In Toronto, for example,01:30 on November 7th 2010 occurred twice (once inside of daylightsavings time and the next, an hour later, outside of daylight savingstime). In this case, the different value of type
would result in adifferent interval being returned.
It is still possible for this function to fail. In Toronto, forexample, 02:00 on March 14th 2010 does not exist (due to the leapforward to begin daylight savings time). -1 is returned in thatcase.
Parameters
tz | a GTimeZone |
type | the GTimeType of |
time_ | a number of seconds since January 1, 1970 |
Returns
the interval containing time_
, or -1 in case of failure
Since: 2.26
g_time_zone_adjust_time ()
Finds an interval within tz
that corresponds to the given time_
,possibly adjusting time_
if required to fit into an interval.The meaning of time_
depends on type
.
This function is similar to g_time_zone_find_interval()
, with thedifference that it always succeeds (by making the adjustmentsdescribed below).
In any of the cases where g_time_zone_find_interval()
succeeds thenthis function returns the same value, without modifying time_
.
This function may, however, modify time_
in order to deal withnon-existent times. If the non-existent local time_
of 02:30 wererequested on March 14th 2010 in Toronto then this function wouldadjust time_
to be 03:00 and return the interval containing theadjusted time.
Parameters
tz | a GTimeZone |
type | the GTimeType of |
time_ | a pointer to a number of seconds since January 1, 1970 |
Since: 2.26
g_time_zone_get_identifier ()
Get the identifier of this GTimeZone, as passed to g_time_zone_new()
.If the identifier passed at construction time was not recognised, UTC
willbe returned. If it was NULL
, the identifier of the local timezone atconstruction time will be returned.
The identifier will be returned in the same format as provided atconstruction time: if provided as a time offset, that will be returned bythis function.
Parameters
Returns
identifier for this timezone
Since: 2.58
g_time_zone_get_abbreviation ()
Determines the time zone abbreviation to be used during a particularinterval
of time in the time zone tz
.
For example, in Toronto this is currently 'EST' during the wintermonths and 'EDT' during the summer months when daylight savings timeis in effect.
Parameters
tz | a GTimeZone |
interval | an interval within the timezone |
Returns
the time zone abbreviation, which belongs to tz
Since: 2.26
g_time_zone_get_offset ()
Determines the offset to UTC in effect during a particular interval
of time in the time zone tz
.
The offset is the number of seconds that you add to UTC time toarrive at local time for tz
(ie: negative numbers for time zoneswest of GMT, positive numbers for east).
Parameters
tz | a GTimeZone |
interval | an interval within the timezone |
Returns
the number of seconds that should be added to UTC to get thelocal time in tz
Since: 2.26
g_time_zone_is_dst ()
Determines if daylight savings time is in effect during a particularinterval
of time in the time zone tz
.
Parameters
tz | a GTimeZone |
interval | an interval within the timezone |
Since: 2.26
Types and Values
GTimeZone
GTimeZone is an opaque structure whose members cannot be accesseddirectly.
Since: 2.26
enum GTimeType
Disambiguates a given time in two ways.
First, specifies if the given time is in universal or local time.
Second, if the time is in local time, specifies if it is localstandard time or local daylight time. This is important for the casewhere the same local time occurs twice (during daylight savings timetransitions, for example).
Gnome Starting Zone
Members
G_TIME_TYPE_STANDARD | the time is in local standard time |
G_TIME_TYPE_DAYLIGHT | the time is in local daylight time |
G_TIME_TYPE_UNIVERSAL | the time is in UTC |