#date-parser #date-time #date-time-parser #time-parser

human-date-parser

Parses strings that express dates in a human way into ones usable by code

5 unstable releases

new 0.3.0 Mar 26, 2025
0.2.0 Sep 5, 2024
0.1.2 Apr 4, 2024
0.1.1 Jan 26, 2023
0.1.0 Jan 21, 2023

#187 in Date and time

Download history 2435/week @ 2024-12-04 2092/week @ 2024-12-11 2093/week @ 2024-12-18 2708/week @ 2024-12-25 2109/week @ 2025-01-01 2241/week @ 2025-01-08 2322/week @ 2025-01-15 2421/week @ 2025-01-22 2711/week @ 2025-01-29 3334/week @ 2025-02-05 2517/week @ 2025-02-12 2557/week @ 2025-02-19 2031/week @ 2025-02-26 2025/week @ 2025-03-05 2857/week @ 2025-03-12 3853/week @ 2025-03-19

11,108 downloads per month
Used in 19 crates (3 directly)

MIT license

38KB
1K SLoC

Rust 837 SLoC Pest 173 SLoC

Human Date Parser

Parses strings that express dates in a human way into ones usable by code.

Usage

Using it is as simple as calling from_human_time with a string slice. Like this:

use human_date_parser::from_human_time;

fn main() {
    let date = from_human_time("Last Friday at 19:45").unwrap();
    println!("{date}");
}

You can also use the example to try out a few dates and see what it can and can't parse. Simply run cargo run --example stdin.

Formats

Currently the following kinds of formats are supported:

  • Today 18:30
  • 2022-11-07 13:25:30
  • 15:20 Friday
  • This Friday 17:00
  • 13:25, Next Tuesday
  • Last Friday at 19:45
  • In 3 days
  • In 2 hours
  • 10 hours and 5 minutes ago
  • 1 years ago
  • A year ago
  • A month ago
  • A week ago
  • A day ago
  • An hour ago
  • A minute ago
  • A second ago
  • Now
  • Yesterday
  • Tomorrow
  • Overmorrow

Issues

If you find issues or opportunities for improvement do let me know by creating a issues on this projects GitHub page.

Dependencies

~4MB
~76K SLoC