Parses a variety of human-readable time formats.
Supports positive and negative durations.
Allows for chaining time units (e.g., "1 hour 2 minutes" or "2 days and 2 hours").

Usage

Add this to your Cargo.toml:

[dependencies]
humantime_to_duration = "0.1.0"

Then, import the crate and use the from_str function:

use humantime_to_duration::from_str;
use time::Duration;

let duration = from_str("+3 days");
assert_eq!(duration.unwrap(), Duration::days(3));

Supported Formats

The from_str function supports the following formats for relative time:

num unit (e.g., "-1 hour", "+3 days")
unit (e.g., "hour", "day")
"now" or "today"
"yesterday"
"tomorrow"
use "ago" for the past
combined units with "and" or "," (e.g., "2 years and 1 month", "1 day, 2 hours" or "2 weeks 1 second")

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.

Return Values

The from_str function returns:

Ok(Duration) - If the input string can be parsed as a relative time
Err(ParseDurationError) - If the input string cannot be parsed as a relative time

This function will return Err(ParseDurationError::InvalidInput) if the input string cannot be parsed as a relative time.

## Fuzzer

To run the fuzzer:

$ cargo fuzz run fuzz_from_str

License

This project is licensed under the MIT License.