human-date-parser

Crates.iohuman-date-parser
lib.rshuman-date-parser
version0.3.1
created_at2023-01-21 23:21:17.526081+00
updated_at2025-03-27 16:57:09.663417+00
descriptionParses strings that express dates in a human way into ones usable by code.
homepagehttps://github.com/technologicalMayhem/human-date-parser
repositoryhttps://github.com/technologicalMayhem/human-date-parser
max_upload_size
id764646
size59,370
Tobias Freese (technologicalMayhem)

documentation

README

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 and the current date and time. Like this:

use human_date_parser::from_human_time;
use chrono::Local;

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

The date and time doesn't have to be 'now' specifically. It's used to figure out what a relative statement like "Next Monday" would actually mean, given the 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.

Commit count: 37

cargo fmt