human-date-parser 0.3.1

Parses strings that express dates in a human way into ones usable by code.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# 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:

```rust
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](https://github.com/technologicalMayhem/human-date-parser) page.