Struct TimeDiff

pub struct TimeDiff { /* private fields */ }

A wrapper type associated with locale and to info.

Implementations

impl TimeDiff

pub fn to_diff(to: String) -> Self

Receive a duration string from input and initiate a TimeDiff struct.

And the duration string should be a human-readable string like 3d and etc. more human-readable duration detail -> humantime

Exmaple

use timediff::*;
assert_eq!(TimeDiff::to_diff(String::from("-10s")).parse(),Ok(String::from("a few seconds ago")))

pub fn to_diff_duration(to: Duration) -> Self

Receive a std duration and initiate a TimeDiff struct.

Exmaple

use timediff::*;
use std::time::Duration;
assert_eq!(TimeDiff::to_diff_duration(Duration::new(30 * 60, 0)).parse(),Ok(String::from("in 30 minutes")))

pub fn locale(&mut self, l: String) -> Result<&mut Self, Error>

Change the locale used for the diff operation on TimeDiff. Default locale is en-US, supports zh-CN, tr-TR, ru-RU and etc. if a custom locale is not supported currently, will return a not found error.

Exmaple

use timediff::*;
use timediff::TimeDiffError as Error;
assert_eq!(
    TimeDiff::to_diff(String::from("-10s"))
        .locale(String::from("zh-CN"))
        .unwrap()
        .parse(),
    Ok(String::from("几秒前"))
);

assert_eq!(
    TimeDiff::to_diff(String::from("10day")).locale(String::from("unknown")),
    Err(Error::NotFoundLocale(String::from("unknown")))
);

pub fn parse(&mut self) -> Result<String, DurationError>

Parses and prints a human-readable string representing the difference between two timestamps (a period of a duration)

Exmaple

use timediff::*;
assert_eq!(TimeDiff::to_diff(String::from("-10s")).parse(),Ok(String::from("a few seconds ago")))

Trait Implementations

impl Debug for TimeDiff

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

Formats the value using the given formatter.

impl PartialEq for TimeDiff

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