Date Time Parser: Rust NLP Library

It aims to parse unstructered text into NaiveDate and NaiveTime formats.

• Date Time Parser has the ability to be timezone aware, but defaults to UTC.
• Allows for parse to be relative to current date/time, or relative to a custom date/time.
• Leverages chrono and regex crates.

Usage

Put this in your Cargo.toml:

[dependencies]
date_time_parser = "0.1.0"

Then put this in your crate root:

extern crate date_time_parser;

Example: Find a Date

General use of this package involves passing English natural language that includes a date to the DateParser struct to parse the expression. If a date is found, it will parse the expression into the NaiveDate format.

use date_time_parser::DateParser;
use chrono::NaiveDate;

let date = DateParser::parse("Lunch on June 5th");
assert_eq!(date, Some(NaiveDate::from_ymd(2020, 6, 5)));

Example: Find a Time

Similarly to parsing dates, this package can also be used to parse time expressions. Pass English natural language that includes a time (relative or absolute) to the TimeParser struct to parse the text. A successful parse results in a NaiveTime from the natural language expression.

use date_time_parser::TimeParser;
use chrono::NaiveTime;

let time = TimeParser::parse("6:30pm dinner");
assert_eq!(time, Some(NaiveTime::from_hms(18, 30, 0)));

Example: Not a Date/Time

If the package gets an expression that for it cannot find a valid date or time, the TimeParser::parse function will return None for that string.

use date_time_parser::TimeParser;
use chrono::NaiveTime;

let time = TimeParser::parse("foo bar");
assert_eq!(time, None);