Struct clocksource::precise::UnixInstant

pub struct UnixInstant { /* private fields */ }

A measurement of the system clock in nanoseconds.

An precise::UnixInstant represents a moment in time and is taken from the system realtime clock. Unlike std::time::SystemTime the internal representation uses only nanoseconds in a u64 field to hold the clock reading.

This will wrap on Jul 21 2554 (UTC) and cannot represent times before the UNIX epoch on Jan 01 1970 (UTC).

As with std::time::SystemTime, UnixInstants are not guaranteed to be steady. They are taken from a clock which is subject to phase and frequency adjustments. This means that they may jump forward or backwards and speed up or slow down.

This type is useful for representing moments in time across restarts and across systems as long as the clocks are reasonably synchronized to a common reference.

The size of a precise::UnixInstant is always the same as a u64.

Implementations

impl UnixInstant

pub const EPOCH: UnixInstant = _

An anchor in time defined as 1970-01-01T00:00:00.000Z. It can be used to create new UnixInstants or learn about other UnixInstants.

pub fn now() -> Self

Return a UnixInstant that represents the current moment in time.

pub fn elapsed(&self) -> Duration

Return the elapsed time, in nanoseconds, since the original timestamp.

pub fn duration_since(&self, earlier: Self) -> Duration

Return the elapsed duration, in nanoseconds, from some earlier timestamp until this timestamp.

pub fn checked_duration_since(&self, earlier: Self) -> Option<Duration>

pub fn checked_sub(&self, duration: Duration) -> Option<Self>

Trait Implementations

impl Add<Duration> for UnixInstant

type Output = UnixInstant

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Duration> for UnixInstant

type Output = UnixInstant

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<Duration> for UnixInstant

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl AddAssign<Duration> for UnixInstant

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl Clone for UnixInstant

fn clone(&self) -> UnixInstant

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UnixInstant

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

Formats the value using the given formatter.

impl Default for UnixInstant

fn default() -> UnixInstant

Returns the “default value” for a type.

impl From<UnixInstant> for AtomicUnixInstant

fn from(other: UnixInstant) -> Self

Converts to this type from the input type.

impl From<UnixInstant> for DateTime

fn from(other: UnixInstant) -> Self

Converts to this type from the input type.

impl From<UnixInstant> for UnixInstant

fn from(other: UnixInstant) -> Self

Converts to this type from the input type.

impl Hash for UnixInstant

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 UnixInstant

fn cmp(&self, other: &UnixInstant) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for UnixInstant

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for UnixInstant

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Sub<Duration> for UnixInstant

type Output = UnixInstant

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Duration> for UnixInstant

type Output = UnixInstant

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for UnixInstant

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<Duration> for UnixInstant

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl SubAssign<Duration> for UnixInstant

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl TryFrom<SystemTime> for UnixInstant

type Error = TryFromError

The type returned in the event of a conversion error.

fn try_from(other: SystemTime) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<UnixInstant> for AtomicUnixInstant

type Error = TryFromError

The type returned in the event of a conversion error.

fn try_from(other: UnixInstant) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<UnixInstant> for UnixInstant

type Error = TryFromError

The type returned in the event of a conversion error.

fn try_from(other: UnixInstant) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for UnixInstant

impl Eq for UnixInstant

impl StructuralEq for UnixInstant

impl StructuralPartialEq for UnixInstant