A Rust crate for parsing human-readable relative time strings and converting them to a Duration
.
Add this to your Cargo.toml
:
toml
[dependencies]
humantime_to_duration = "0.3.0"
Then, import the crate and use the from_str
and from_str_at_date
functions:
```rs
use humantimetoduration::{fromstr, fromstratdate};
use chrono::Duration;
let duration = fromstr("+3 days"); asserteq!(duration.unwrap(), Duration::days(3));
let today = Utc::today().naiveutc(); let yesterday = today - Duration::days(1); asserteq!( fromstrat_date(yesterday, "2 days").unwrap(), Duration::days(1) ); ```
The from_str
and from_str_at_date
functions support the following formats for relative time:
num
unit
(e.g., "-1 hour", "+3 days")unit
(e.g., "hour", "day")num
can be a positive or negative integer.
unit
can be one of the following: "fortnight", "week", "day", "hour", "minute", "min", "second", "sec" and their plural forms.
The from_str
and from_str_at_date
functions return:
Ok(Duration)
- If the input string can be parsed as a relative timeErr(ParseDurationError)
- If the input string cannot be parsed as a relative timeThis function will return Err(ParseDurationError::InvalidInput)
if the input string
cannot be parsed as a relative time.
To run the fuzzer:
$ cargo fuzz run fuzz_from_str
This project is licensed under the MIT License.