Struct Time 

pub struct Time { /* private fields */ }

One instant in real-life

It can hold any time between roughly 10^22 years before and after posix epoch.

Implementations

impl Time

pub const POSIX_EPOCH: Time

The posix epoch (1970-01-01T00:00:00 Gregorian UTC)

pub fn try_now() -> Result<TimeResult>

Return the current time as indicated by the system timezone

Note that this will panic in no-std environments if an alternative way of getting the time is not known for the platform.

pub fn now() -> Time

Return the current time

If the system clock (as returned by Rust’s SystemTime::now()) is in a non-UTC timezone mode, then this will return any one of the possible Times corresponding to the time returned by the system clock. This should not happen anyway as Rust’s SystemTime should return POSIX timestamps (so, UTC) even when the system clock is set to local time, so there should be no issue in relying on this function.

Note that this will panic in no-std environments if an alternative way of getting the time is not known for the platform.

pub fn read<Tim: CalendarTime>(t: Tim) -> Result<TimeResult>

Read the current time from a given written time

pub fn write<Cal: Calendar>(&self, cal: Cal) -> Result<WrittenTime<Cal>>

Write the current time in a given calendar

pub const fn checked_add(&self, rhs: &Duration) -> Option<Time>

Offset by a duration, returning None on (however unlikely) overflow

pub const fn checked_sub(&self, rhs: &Duration) -> Option<Time>

Offset by a duration, returning None on (however unlikely) overflow

pub fn duration_since(&self, rhs: &Time) -> Duration

Return the duration elapsed since the other point in time

pub fn checked_duration_since(&self, rhs: &Time) -> Option<Duration>

Return the duration elapsed since the other point in time

Returns None on the (however unlikely) overflow

Trait Implementations

impl Add<Duration> for Time

type Output = Time

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Self::Output

Performs the + operation.

impl AddAssign<Duration> for Time

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl Clone for Time

fn clone(&self) -> Time

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Time

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Time

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Time

fn cmp(&self, other: &Time) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Time

fn eq(&self, other: &Time) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Time

fn partial_cmp(&self, other: &Time) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub<Duration> for Time

type Output = Time

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Self::Output

Performs the - operation.

impl Sub for Time

type Output = Duration

The resulting type after applying the - operator.

fn sub(self, rhs: Time) -> Self::Output

Performs the - operation.

impl SubAssign<Duration> for Time

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl Copy for Time

impl Eq for Time

impl StructuralPartialEq for Time