Crate date_time_parser
source · [−]Expand description
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::{prelude::*, Duration, Local, NaiveDate, NaiveDateTime, Weekday};
let date = DateParser::parse("Lunch on June 5th");
let year = Local::now().year();
assert_eq!(date, Some(NaiveDate::from_ymd(year, 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);Structs
Container for parsing dates from string slices.
Container for parsing times from string slices.
Traits
An interface for dealing with parsing unstructured text. Implement this trait for your abstract syntax when parsing.