29 releases (9 breaking)
new 0.11.3 | Nov 28, 2024 |
---|---|
0.11.2 | Jun 6, 2024 |
0.10.0 | May 10, 2024 |
0.7.1 | Dec 11, 2023 |
0.2.0 | Mar 16, 2021 |
#7 in Date and time
78,839 downloads per month
Used in 44 crates
(31 directly)
105KB
1.5K
SLoC
parse string to std::time::Duration
Features:
- 🚀 Strong compatibility, accommodating leading or trailing whitespaces in strings.
- 👍️ Offers Playground support for online debugging.
- ⭐ Integrated with the serde library.
- 🎉 Supports parsing of various
Duration
types: - 🔥 Enables formatting of
Duration
into human-readable formats. - 🍻 Provides precise error localization for easy troubleshooting.
- ⚡ Compatible with WebAssembly (wasm).
- 🎨 Adapts to the humantime crate, despite its apparent lack of recent updates...
Notice ⚠️
The default duration unit is second.Also use below duration unit
Duration Unit List
Parse string to Duration
. The String duration unit support for one
of:["y","mon","w","d","h","m","s", "ms", "µs", "ns"]
unit | Description | unit list option(one of) | example |
---|---|---|---|
y | Year | ["y" , "year" , "Y" , "YEAR" , "Year"] | 1y |
mon | Month | ["mon" , "MON" , "Month" , "month" , "MONTH"] | 1mon |
w | Week | ["w" , "W" , "Week" ,"WEEK" , "week"] | 1w |
d | Day | ["d" , "D" , "Day" , "DAY" , "day"] | 1d |
h | Hour | ["h" , "hr" , "H" , "Hour" , "HOUR" , "hour"] | 1h |
m | Minute | ["m" , "M" , "Minute" , "MINUTE" , "minute" , "min" , "MIN"] | 1m |
s | Second | ["s" , "S" , "Second" , "SECOND" , "second" , "sec" , "SEC"] | 1s |
ms | Millisecond | ["ms" , "MS" , "Millisecond" , "MilliSecond" , "MILLISECOND" , "millisecond" , "mSEC"] | 1ms |
µs | Microsecond | ["µs" , "µS" , "µsecond" , "Microsecond" , "MicroSecond" , "MICROSECOND" , "microsecond" , "µSEC"] | 1µs |
ns | Nanosecond | ["ns" , "NS" , "Nanosecond" , "NanoSecond" , "NANOSECOND" , "nanosecond" , "nSEC"] | 1ns |
Also,duration_str
support time duration simple evaluation(+,*). See example:
example
[dependencies]
duration-str = "{latest version}"
use duration_str::parse;
use std::time::Duration;
fn main() {
let duration = parse("1d").unwrap();
assert_eq!(duration, Duration::new(24 * 60 * 60, 0));
let duration = parse("3m+31").unwrap(); //the default duration unit is second.
assert_eq!(duration, Duration::new(211, 0));
let duration = parse("3m + 31").unwrap(); //the default duration unit is second.
assert_eq!(duration, Duration::new(211, 0));
let duration = parse("3m31s").unwrap();
assert_eq!(duration, Duration::new(211, 0));
let duration = parse("3m + 13s + 29ms").unwrap();
assert_eq!(duration, Duration::new(193, 29 * 1000 * 1000 + 0 + 0));
let duration = parse("3m + 1s + 29ms +17µs").unwrap();
assert_eq!(
duration,
Duration::new(181, 29 * 1000 * 1000 + 17 * 1000 + 0)
);
let duration = parse("1m*10").unwrap(); //the default duration unit is second.
assert_eq!(duration, Duration::new(600, 0));
let duration = parse("1m*10ms").unwrap();
assert_eq!(duration, Duration::new(0, 600 * 1000 * 1000));
let duration = parse("1m * 1ns").unwrap();
assert_eq!(duration, Duration::new(0, 60));
let duration = parse("1m * 1m").unwrap();
assert_eq!(duration, Duration::new(3600, 0));
}
deserialize in struct
deserialize to std::time::Duration
use duration_str::deserialize_duration;
use serde::*;
use std::time::Duration;
#[derive(Debug, Deserialize)]
struct Config {
#[serde(deserialize_with = "deserialize_duration")]
time_ticker: Duration,
}
fn main() {
let json = r#"{"time_ticker":"1m+30"}"#;
let config: Config = serde_json::from_str(json).unwrap();
assert_eq!(config.time_ticker, Duration::new(60 + 30, 0));
let json = r#"{"time_ticker":"1m+30s"}"#;
let config: Config = serde_json::from_str(json).unwrap();
assert_eq!(config.time_ticker, Duration::new(60 + 30, 0));
}
- option filed deserialize
use duration_str::deserialize_option_duration;
use serde::*;
use std::time::Duration;
#[derive(Debug, Deserialize, PartialEq)]
struct Config {
#[serde(default, deserialize_with = "deserialize_option_duration")]
time_ticker: Option<Duration>,
name: String,
}
fn main() {
let json = r#"{"time_ticker":null,"name":"foo"}"#;
let config: Config = serde_json::from_str(json).unwrap();
assert_eq!(
config,
Config {
time_ticker: None,
name: "foo".into()
}
);
let json = r#"{"name":"foo"}"#;
let config: Config = serde_json::from_str(json).unwrap();
assert_eq!(
config,
Config {
time_ticker: None,
name: "foo".into()
}
);
}
Also you can use deserialize_duration_chrono
or deserialize_duration_time
function
E.g:
use chrono::Duration;
use duration_str::deserialize_duration_chrono;
use serde::*;
#[derive(Debug, Deserialize)]
struct Config {
#[serde(deserialize_with = "deserialize_duration_chrono")]
time_ticker: Duration,
}
fn main() {
let json = r#"{"time_ticker":"1m+30"}"#;
let config: Config = serde_json::from_str(json).unwrap();
assert_eq!(config.time_ticker, Duration::seconds(60 + 30));
}
Dependencies
~4MB
~77K SLoC