Struct glib::TimeZone [−][src]
pub struct TimeZone(_);
Expand description
TimeZone
is an opaque structure whose members cannot be accessed
directly.
Implementations
A version of g_time_zone_new_identifier()
which returns the UTC time zone
if identifier
could not be parsed or loaded.
If you need to check whether identifier
was loaded successfully, use
g_time_zone_new_identifier()
.
Deprecated since 2.68
Use g_time_zone_new_identifier()
instead, as it provides
error reporting. Change your code to handle a potentially None
return
value.
identifier
a timezone identifier
Returns
the requested timezone
Creates a TimeZone
corresponding to local time. The local time
zone may change between invocations to this function; for example,
if the system administrator changes it.
This is equivalent to calling new()
with the value of
the TZ
environment variable (including the possibility of None
).
You should release the return value by calling g_time_zone_unref()
when you are done with it.
Returns
the local timezone
This is supported on crate feature v2_58
only.
v2_58
only.Finds an interval within self
that corresponds to the given time_
.
The meaning of time_
depends on type_
.
If type_
is TimeType::Universal
then this function will always
succeed (since universal time is monotonic and continuous).
Otherwise time_
is treated as local time. The distinction between
TimeType::Standard
and TimeType::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.
type_
the TimeType
of time_
time_
a number of seconds since January 1, 1970
Returns
the interval containing time_
, or -1 in case of failure
Determines the time zone abbreviation to be used during a particular
interval
of time in the time zone self
.
For example, in Toronto this is currently “EST” during the winter months and “EDT” during the summer months when daylight savings time is in effect.
interval
an interval within the timezone
Returns
the time zone abbreviation, which belongs to self
This is supported on crate feature v2_58
only.
v2_58
only.Get the identifier of this TimeZone
, as passed to new()
.
If the identifier passed at construction time was not recognised, UTC
will
be returned. If it was None
, the identifier of the local timezone at
construction time will be returned.
The identifier will be returned in the same format as provided at construction time: if provided as a time offset, that will be returned by this function.
Returns
identifier for this timezone
Determines the offset to UTC in effect during a particular interval
of time in the time zone self
.
The offset is the number of seconds that you add to UTC time to
arrive at local time for self
(ie: negative numbers for time zones
west of GMT, positive numbers for east).
interval
an interval within the timezone
Returns
the number of seconds that should be added to UTC to get the
local time in self
Trait Implementations
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Returns the type identifier of Self
.
Auto Trait Implementations
Blanket Implementations
Mutably borrows from an owned value. Read more
Returns a SendValue
clone of self
.
impl<'a, T, C> FromValueOptional<'a> for T where
C: ValueTypeChecker<Error = ValueTypeMismatchOrNoneError>,
T: FromValue<'a, Checker = C>,