bin+lib timeago

Given a Duration, lossily format it like in ‘N days ago’. Parsing it back to Duration is not supported yet.

9 releases

0.2.0 Apr 8, 2019
0.1.5 Apr 12, 2018
0.1.3 Mar 28, 2018
0.0.2 Sep 21, 2017
0.0.1 Aug 12, 2017

#7 in Date and time

Download history 32/week @ 2018-12-24 7/week @ 2018-12-31 61/week @ 2019-01-07 22/week @ 2019-01-14 45/week @ 2019-01-21 10/week @ 2019-01-28 2/week @ 2019-02-04 2/week @ 2019-02-11 11/week @ 2019-02-18 29/week @ 2019-02-25 38/week @ 2019-03-04 4/week @ 2019-03-11 12/week @ 2019-03-18 46/week @ 2019-03-25 14/week @ 2019-04-01

96 downloads per month
Used in 1 crate

MIT/Apache

59KB
1K SLoC

timeago

In Rust, format Duration into string like "1 hour ago" or "01hou".

Currently it does not take the calendar into account and assumes each month is about 30.4 days long.

Parsing such string back to a Duration is out of scope for this crate. Maybe see the chrono-english crate instead.

API

Documentation link

Simplified API excerpt (pseudocode):

pub struct Formatter<L : Language = English>{...}

impl Formatter {
    pub fn new() -> Formatter<English>;
    pub fn with_language(l: Language) -> Self;
    pub fn num_items(&mut self, x: usize) -> &mut Self;
    pub fn max_unit(&mut self, x: TimeUnit) -> &mut Self;
    pub fn min_unit(&mut self, x: TimeUnit) -> &mut Self;
    pub fn too_low(&mut self, x: &'static str) -> &mut Self;
    pub fn too_high(&mut self, x: &'static str) -> &mut Self;
    pub fn max_duration(&mut self, x: Duration) -> &mut Self;
    pub fn ago(&mut self, x: &'static str) -> &mut Self;
    
    pub fn convert(&self, d: Duration) -> String;
    pub fn convert_chrono(&self, from: chrono::DateTime, to: chrono::DateTime) -> String;
}

pub fn from_isolang(x : isolang::Language) -> Option<Box<Language>>;

pub fn format_5chars(d: Duration) -> String;

A Language can be constructed from isolang::Language.

Translations

  • English
  • Russian
  • Spanish (contributed)
  • German (unchecked)
  • Belarusian (unchecked)
  • Polish (unchecked)
  • Chinese (contributed)
  • Romanian (contributed)
  • Swedish (contributed)
  • Turkish (contributed)
  • Japanese (contributed)
  • French (contributed)

If you checked some language and certify that it's allright, submit a pull request that removes "(unchecked)" or "(contributed)" in the list above.

Tool

There is a helper command line tool that allows easier experimenting when adding a new translation:

$ cargo run --features isolang en
    Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs
     Running `target/debug/timeago en`
60
1 minute ago
7200
2 hours ago

See also

Dependencies

~1MB
~13K SLoC