Struct hourglass::Timespec
[−]
[src]
pub struct Timespec { /* fields omitted */ }
An offset from the Unix Epoch.
Timespec
is the building block of Datetime
and can be converted
from and to a Datetime
. It is intrinsically expressed in the UTC
timezone since it holds the number of seconds elapsed since the Unix
Epoch 1970-01-01T00:00:00Z
and therefore is not ambiguous.
It is equivalent to a Datetime
without Timezone
information and
therefore does not have access to as much methods as its counterpart.
For example, its date
representation cannot be computed. In return,
the type is simpler and easier to handle and move around. Like
Datetime
, Timespec
is leap second aware.
Methods
impl Timespec
[src]
fn now() -> Timespec
Return the Timespec
representing now.
fn unix(stamp: i64, nano: i32) -> Result<Timespec, InputError>
Create a new Timespec
from a Unix timestamp. An InputError
is returned if nano
∉ [0, 999999999].
fn seconds(&self) -> i64
Get the number of Unix seconds since the Unix Epoch.
fn nanoseconds(&self) -> i32
Get the number of nanoseconds elapsed for the current second.
fn to_datetime<'a>(&self, tz: &'a Timezone) -> Datetime<'a>
Convert the Timespec
into a Datetime
, given a Timezone
.
Note the Timespec
is always expressed as a Unix time, so
converting to a Datetime
won't interpret the Timespec
as
anything other than an offset from Unix Epoch in UTC
timezone.
Trait Implementations
impl Clone for Timespec
[src]
fn clone(&self) -> Timespec
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more
impl Copy for Timespec
[src]
impl Debug for Timespec
[src]
impl PartialEq<Timespec> for Timespec
[src]
fn eq(&self, other: &Timespec) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Rhs) -> bool
1.0.0
This method tests for !=
.
impl Eq for Timespec
[src]
impl PartialOrd<Timespec> for Timespec
[src]
fn partial_cmp(&self, other: &Timespec) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
1.0.0
This method tests less than (for self
and other
) and is used by the <
operator. Read more
fn le(&self, other: &Rhs) -> bool
1.0.0
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
fn gt(&self, other: &Rhs) -> bool
1.0.0
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
fn ge(&self, other: &Rhs) -> bool
1.0.0
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl Ord for Timespec
[src]
fn cmp(&self, other: &Timespec) -> Ordering
This method returns an Ordering
between self
and other
. Read more
impl Add<Deltatime> for Timespec
[src]
type Output = Timespec
The resulting type after applying the +
operator
fn add(self, rhs: Deltatime) -> Self::Output
The method for the +
operator
impl Sub<Deltatime> for Timespec
[src]
type Output = Timespec
The resulting type after applying the -
operator
fn sub(self, rhs: Deltatime) -> Self::Output
The method for the -
operator