Method
GLibTimeZonefind_interval
since: 2.26
Declaration [src]
gint
g_time_zone_find_interval (
GTimeZone* tz,
GTimeType type,
gint64 time_
)
Description [src]
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 always
succeed (since universal time is monotonic and continuous).
Otherwise time_
is treated as local time. The distinction between
G_TIME_TYPE_STANDARD
and G_TIME_TYPE_DAYLIGHT
is ignored except in
the case that the given time_
is ambiguous. In Toronto, for example,
01:30 on November 7th 2010 occurred twice (once inside of daylight
savings time and the next, an hour later, outside of daylight savings
time). In this case, the different value of type
would result in a
different interval being returned.
It is still possible for this function to fail. In Toronto, for example, 02:00 on March 14th 2010 does not exist (due to the leap forward to begin daylight savings time). -1 is returned in that case.
Available since: 2.26
Parameters
type
-
Type:
GTimeType
The
GTimeType
oftime_
. time_
-
Type:
gint64
A number of seconds since January 1, 1970.