Struct Duration

pub struct Duration { /* private fields */ }

A duration measured in nanoseconds.

An duration represents a span of time. Unlike std::time::Instant the internal representation uses only nanoseconds in a u64 field to represent the span of time. This means that the max duration is ~584 years.

Implementations

impl Duration

pub const MAX: Duration

The maximum representable precise::Duration.

pub const SECOND: Duration

One second as a precise::Duration.

pub const MILLISECOND: Duration

One millisecond as a precise::Duration.

pub const MICROSECOND: Duration

One microsecond as a precise::Duration.

pub const NANOSECOND: Duration

One nanosecond as a precise::Duration.

pub const fn from_secs(secs: u32) -> Self

Create a new Duration from a whole number of seconds.

pub const fn from_millis(millis: u32) -> Self

Create a new Duration from a whole number of milliseconds.

pub const fn try_from_millis(millis: u64) -> Result<Self, TryFromError>

Create a new Duration from a whole number of milliseconds.

Note: this will return an error on overflow.

pub const fn from_micros(micros: u32) -> Self

Create a new Duration from a whole number of microseconds.

pub const fn try_from_micros(micros: u64) -> Result<Self, TryFromError>

Create a new Duration from a whole number of microseconds.

Note: this will return an error on overflow.

pub const fn from_nanos(nanos: u64) -> Self

Create a new Duration from a whole number of nanoseconds.

pub const fn as_nanos(&self) -> u64

Returns the whole number of nanoseconds within the Duration.

pub const fn as_micros(&self) -> u64

Returns the whole number of nanoseconds within the Duration.

pub const fn as_millis(&self) -> u64

pub const fn as_secs(&self) -> u64

Returns the number of whole seconds represented by this Duration.

This does not include any fractional parts of a second. Use subsec_nanos to get the remainder in nanoseconds. Use as_secs_f64 if you want the total number of seconds including the fractional part.

pub const fn subsec_nanos(&self) -> u32

Returns the remaining number of nanoseconds in this Duration when ignoring the whole number of seconds.

pub fn as_secs_f64(&self) -> f64

Returns the total number of seconds represented by this Duration.

pub fn mul_f64(self, rhs: f64) -> Self

Multiply this Duration by a f64.

Trait Implementations

impl Add<Duration> for Instant

type Output = Instant

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 Add for Duration

type Output = Duration

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<Duration> for Instant

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 AddAssign for Duration

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl Clone for Duration

fn clone(&self) -> Duration

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Duration

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

Formats the value using the given formatter.

impl Default for Duration

fn default() -> Duration

Returns the “default value” for a type.

impl Div<u64> for Duration

type Output = Duration

The resulting type after applying the / operator.

fn div(self, rhs: u64) -> Self::Output

Performs the / operation.

impl DivAssign<u64> for Duration

fn div_assign(&mut self, rhs: u64)

Performs the /= operation.

impl From<Duration> for AtomicDuration

fn from(other: Duration) -> Self

Converts to this type from the input type.

impl From<Duration> for Duration

fn from(other: Duration) -> Self

Converts to this type from the input type.

impl Hash for Duration

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 Mul<u64> for Duration

type Output = Duration

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> Self::Output

Performs the * operation.

impl MulAssign<u64> for Duration

fn mul_assign(&mut self, rhs: u64)

Performs the *= operation.

impl Ord for Duration

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

fn eq(&self, other: &Duration) -> 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 Duration

fn partial_cmp(&self, other: &Duration) -> 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 Rem for Duration

type Output = Duration

The resulting type after applying the % operator.

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

Performs the % operation.

impl Sub<Duration> for Instant

type Output = Instant

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 Duration

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<Duration> for Instant

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 SubAssign for Duration

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl TryFrom<Duration> for Duration

type Error = TryFromError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for Duration

impl Eq for Duration

impl StructuralPartialEq for Duration