Struct readable::Time

pub struct Time(_, _);

Human-readable std::time::Duration.

The input is always assumed to be in seconds.

The inner fields are (f64, String) but they are not public.

From input can be:

• std::time::Duration
• u8, u16, u32, u64, usize
• f32, f64

The lowest unit is second, the highest is year, and week is skipped in favor of 7 days.

Examples

Input	String Output
0	0 seconds
1	1 second
59	59 seconds
3599	59 minutes, 59 seconds
86399	23 hours, 59 minutes, 59 seconds
604799	6 days, 23 hours, 59 minutes, 59 seconds
3234815	1 month, 6 days, 23 hours, 59 minutes, 59 seconds
63115200	2 years

Exceptions

Exception	String Output
f32::NAN & f64::NAN	NaN
f32::INFINITY & f64::INFINITY	∞
f32::NEG_INFINITY & f64::NEG_INFINITY	-∞

Credit

This code is forked from https://docs.rs/humantime, edited to remove sub-second time, change spacing and some words.

Implementations

impl Time

pub fn as_str(&self) -> &str

Return a borrowed str without consuming Self.

pub fn to_string(&self) -> String

Clone’s and returns the inner String.

pub fn to_f64(&self) -> f64

Returns the inner f64.

pub fn into_string(self) -> String

Consumes [Self], returning the inner String.

pub fn into_raw(self) -> (f64, String)

Consumes Self, returning the inner f64 and String.

pub fn unknown() -> Self

Returns a Self with the f64 value of f64::NAN.

The String is set to ???.

pub fn nan() -> Self

Returns a Self with the f64 value of f64::NAN.

The String is set to NaN.

pub fn inf() -> Self

Returns a Self with the f64 value of f64::INFINITY.

The String is set to ∞.

pub fn neg_inf() -> Self

Returns a Self with the f64 value of f64::INFINITY.

The String is set to -∞.

pub fn zero() -> Self

Return (0.0, "0 seconds").

pub fn second() -> Self

Return (1.0, "1 second").

pub fn minute() -> Self

Return (60.0, "1 minute").

pub fn hour() -> Self

Return (3600.0, "1 hour").

pub fn day() -> Self

Return (86400.0, "1 day").

pub fn month() -> Self

Return (2630016.0, "1 month").

pub fn year() -> Self

Return (31557600.0, "1 year").

Trait Implementations

impl Clone for Time

fn clone(&self) -> Time

Returns a copy 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 Display for Time

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

Formats the value using the given formatter.

impl From<&Duration> for Time

fn from(duration: &Duration) -> Self

Converts to this type from the input type.

impl From<Duration> for Time

fn from(duration: Duration) -> Self

Converts to this type from the input type.

impl From<f32> for Time

fn from(number: f32) -> Self

Converts to this type from the input type.

impl From<f64> for Time

fn from(seconds: f64) -> Self

Converts to this type from the input type.

impl From<u16> for Time

fn from(number: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Time

fn from(number: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Time

fn from(number: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Time

fn from(number: u8) -> Self

Converts to this type from the input type.

impl From<usize> for Time

fn from(number: usize) -> Self

Converts to this type from the input type.

impl PartialEq<Time> for Time

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

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 StructuralPartialEq for Time