Struct duration_human::DurationHuman

pub struct DurationHuman { /* private fields */ }

Define a Duration in human readable form

Examples

let duration = DurationHuman::try_from("80h").unwrap();
assert_eq!(format!("{:#}", duration), "3 day 8h".to_string());
assert_eq!(format!("{}", duration), "80h".to_string());
let duration = DurationHuman::try_from("72h").unwrap();
assert_eq!(format!("{:#}", duration), "3 day".to_string());
assert_eq!(format!("{}", duration), "3 day".to_string());
let duration = DurationHuman::try_from("18446744073709551615ns").unwrap();
assert_eq!(format!("{:#}", duration), "5 century 84 year 11 month 1 week 6 day 23h 34min 33s 709ms".to_string());
let duration = DurationHuman::try_from("18446744073709551615ms").unwrap();
assert_eq!(format!("{:#}", duration), "5849424 century 17 year 4 month 1 week 2 day 14h 25min 51s 615ms".to_string());
// precision is ms
let duration = DurationHuman::try_from("604800μs").unwrap();
assert_eq!(format!("{:#}", duration), "604ms".to_string());
assert_eq!(duration.to_string(), "604ms".to_string());
let duration = DurationHuman::try_from("604800ms").unwrap();
assert_eq!(format!("{:#}", duration), "10min 4s 800ms".to_string());
assert_eq!(duration.to_string(), "604800ms".to_string());
let duration = DurationHuman::try_from("604800s").unwrap();
assert_eq!(format!("{:#}", duration), "1 week".to_string());
let duration = DurationHuman::try_from("604800s").unwrap();
assert_eq!(format!("{:#}", duration), "1 week".to_string(),"A");
assert_eq!(format!("{}", duration), "1 week".to_string(),"B");
let duration = DurationHuman::try_from("608430s").unwrap();
assert_eq!(format!("{:#}", duration), "1 week 1h 30s".to_string());
assert_eq!(format!("{}", duration), "608430s".to_string(),"C");

Implementations

impl DurationHuman

pub const ONE_SECOND: Self = _

pub const ONE_MILLISECOND: Self = _

pub const fn new(ms: u64) -> Self

pub fn is_in(&self, range: &DurationHumanValidator) -> bool

Trait Implementations

impl Add<Instant> for DurationHuman

type Output = Instant

The resulting type after applying the + operator.

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

Performs the + operation.

impl Clone for DurationHuman

fn clone(&self) -> DurationHuman

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for DurationHuman

fn default() -> Self

Returns the “default value” for a type.

impl Display for DurationHuman

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

Formats the value using the given formatter.

impl From<&DurationHuman> for Duration

fn from(duration: &DurationHuman) -> Self

Converts to this type from the input type.

impl From<&DurationHuman> for u64

fn from(duration: &DurationHuman) -> Self

Converts to this type from the input type.

impl From<DurationHuman> for OsStr

fn from(duration: DurationHuman) -> Self

Converts to this type from the input type.

impl From<u64> for DurationHuman

fn from(ms: u64) -> Self

Converts to this type from the input type.

impl Parse for DurationHuman

fn parse(input: ParseStream<'_>) -> Result<Self>

impl PartialEq<DurationHuman> for DurationHuman

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

fn partial_cmp(&self, other: &DurationHuman) -> 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 TryFrom<&str> for DurationHuman

type Error = DurationError

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for DurationHuman

impl Eq for DurationHuman

impl StructuralEq for DurationHuman

impl StructuralPartialEq for DurationHuman