Struct dur::Duration

pub struct Duration(/* private fields */);

A human readable duration backed by a u128.

The underlying u128 represents the duration in nanoseconds.

Implementations

impl Duration

pub const HOUR: Self = _

pub const MICROSECOND: Self = _

pub const MILLISECOND: Self = _

pub const MINUTE: Self = _

pub const NANOSECOND: Self = _

pub const SECOND: Self = _

impl Duration

pub const fn from_nanos(ns: u128) -> Self

Creates a new Duration from the specified number of nanoseconds.

pub const fn from_micros(us: u128) -> Self

Creates a new Duration from the specified number of microseconds.

Overflow Behavior

IF the value in nanoseconds overflows a u128, the behavior is the same as with u128 overflow with multiplication.

pub const fn from_millis(ms: u128) -> Self

Creates a new Duration from the specified number of milliseconds.

Overflow Behavior

IF the value in nanoseconds overflows a u128, the behavior is the same as with u128 overflow with multiplication.

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

Creates a new Duration from the specified number of seconds.

Overflow Behavior

IF the value in nanoseconds overflows a u128, the behavior is the same as with u128 overflow with multiplication.

pub fn to_std(self) -> StdDuration

Convert to StdDuration. equivalent to calling Into::into.

Panics

Panics if self is too big for an StdDuration.

pub fn try_to_std(self) -> Option<StdDuration>

Tries to convert self into an StdDuration.

Returns None if the value is too big for StdDuration.

pub const fn from_std(d: StdDuration) -> Self

Convert from StdDuration. Equivalent to Duration::from.

pub const fn as_nanos(self) -> u128

Returns the total number of nanoseconds contained by this Duration.

pub const fn as_micros(self) -> u128

Returns the total number of whole microseconds contained by this Duration.

pub fn as_micros_dec(self) -> Decimal

Returns this duration in microseconds as a Decimal.

pub const fn as_millis(self) -> u128

Returns the total number of whole milliseconds contained by this Duration.

pub fn as_millis_dec(self) -> Decimal

Returns this duration in milliseconds as a Decimal.

pub const fn as_secs(self) -> u128

Returns the total number of whole seconds contained by this Duration.

pub fn as_secs_dec(self) -> Decimal

Returns this duration in seconds as a Decimal.

pub const fn is_zero(self) -> bool

Returns true if this Duration is 0.

pub fn format_exact(self) -> impl Display + Debug + Copy

Returns an opaque object that implements Display without any loss of precision.

Trait Implementations

impl Add<Duration> for Duration

type Output = Duration

The resulting type after applying the + operator.

fn add(self, rhs: StdDuration) -> Self

Performs the + operation.

impl Add<Duration> for Duration

type Output = Duration

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Duration> for SystemTime

type Output = SystemTime

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add for Duration

type Output = Duration

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<Duration> for Duration

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl AddAssign<Duration> for Duration

fn add_assign(&mut self, rhs: StdDuration)

Performs the += operation.

impl AddAssign<Duration> for SystemTime

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl AddAssign for Duration

fn add_assign(&mut self, rhs: Self)

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<'de> Deserialize<'de> for Duration

fn deserialize<D>(deserializer: D) -> Result<Duration, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Duration

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

Formats the value using the given formatter.

impl<T: Into<u128>> Div<T> for Duration

type Output = Duration

The resulting type after applying the / operator.

fn div(self, rhs: T) -> Self

Performs the / operation.

impl<T: Into<u128>> DivAssign<T> for Duration

fn div_assign(&mut self, rhs: T)

Performs the /= operation.

impl From<Duration> for Duration

fn from(d: StdDuration) -> Self

Converts to this type from the input type.

impl From<Duration> for StdDuration

fn from(d: Duration) -> Self

Converts to this type from the input type.

impl FromStr for Duration

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this 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<T: Into<u128>> Mul<T> for Duration

type Output = Duration

The resulting type after applying the * operator.

fn mul(self, rhs: T) -> Self

Performs the * operation.

impl<T: Into<u128>> MulAssign<T> for Duration

fn mul_assign(&mut self, rhs: T)

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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq<Duration> for Duration

fn eq(&self, rhs: &StdDuration) -> 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 PartialEq<Duration> for StdDuration

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

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

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<T: Into<u128>> Rem<T> for Duration

type Output = Duration

The resulting type after applying the % operator.

fn rem(self, rhs: T) -> Self

Performs the % operation.

impl<T: Into<u128>> RemAssign<T> for Duration

fn rem_assign(&mut self, rhs: T)

Performs the %= operation.

impl Serialize for Duration

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<Duration> for Duration

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Duration> for Duration

type Output = Duration

The resulting type after applying the - operator.

fn sub(self, rhs: StdDuration) -> Self

Performs the - operation.

impl Sub<Duration> for SystemTime

type Output = SystemTime

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for Duration

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<Duration> for Duration

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl SubAssign<Duration> for Duration

fn sub_assign(&mut self, rhs: StdDuration)

Performs the -= operation.

impl SubAssign<Duration> for SystemTime

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl SubAssign for Duration

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl ValueParserFactory for Duration

type Parser = DurationParser

Generated parser, usually [ValueParser].

fn value_parser() -> Self::Parser

Create the specified [Self::Parser]

impl Copy for Duration

impl Eq for Duration

impl StructuralEq for Duration

impl StructuralPartialEq for Duration