69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
|
Human Time
|
||
|
|
==========
|
||
|
|
|
||
|
|
**Status: stable**
|
||
|
|
|
||
|
|
[Documentation](https://docs.rs/humantime) |
|
||
|
|
[Github](https://github.com/tailhook/humantime) |
|
||
|
|
[Crate](https://crates.io/crates/humantime)
|
||
|
|
|
||
|
|
|
||
|
|
Features:
|
||
|
|
|
||
|
|
* Parses durations in free form like `15days 2min 2s`
|
||
|
|
* Formats durations in similar form `2years 2min 12us`
|
||
|
|
* Parses and formats timestamp in `rfc3339` format: `2018-01-01T12:53:00Z`
|
||
|
|
* Parses timestamps in a weaker format: `2018-01-01 12:53:00`
|
||
|
|
|
||
|
|
Timestamp parsing/formatting is super-fast because format is basically
|
||
|
|
fixed.
|
||
|
|
|
||
|
|
Here are some micro-benchmarks:
|
||
|
|
|
||
|
|
```
|
||
|
|
test result: ok. 0 passed; 0 failed; 26 ignored; 0 measured; 0 filtered out
|
||
|
|
|
||
|
|
Running target/release/deps/datetime_format-8facb4ac832d9770
|
||
|
|
|
||
|
|
running 2 tests
|
||
|
|
test rfc3339_chrono ... bench: 737 ns/iter (+/- 37)
|
||
|
|
test rfc3339_humantime_seconds ... bench: 73 ns/iter (+/- 2)
|
||
|
|
|
||
|
|
test result: ok. 0 passed; 0 failed; 0 ignored; 2 measured; 0 filtered out
|
||
|
|
|
||
|
|
Running target/release/deps/datetime_parse-342628f877d7867c
|
||
|
|
|
||
|
|
running 6 tests
|
||
|
|
test datetime_utc_parse_millis ... bench: 228 ns/iter (+/- 11)
|
||
|
|
test datetime_utc_parse_nanos ... bench: 236 ns/iter (+/- 10)
|
||
|
|
test datetime_utc_parse_seconds ... bench: 204 ns/iter (+/- 18)
|
||
|
|
test rfc3339_humantime_millis ... bench: 28 ns/iter (+/- 1)
|
||
|
|
test rfc3339_humantime_nanos ... bench: 36 ns/iter (+/- 2)
|
||
|
|
test rfc3339_humantime_seconds ... bench: 24 ns/iter (+/- 1)
|
||
|
|
|
||
|
|
test result: ok. 0 passed; 0 failed; 0 ignored; 6 measured; 0 filtered out
|
||
|
|
```
|
||
|
|
|
||
|
|
See [humantime-serde] for serde integration (previous crate [serde-humantime] looks unmaintained).
|
||
|
|
|
||
|
|
[serde-humantime]: https://docs.rs/serde-humantime/0.1.1/serde_humantime/
|
||
|
|
[humantime-serde]: https://docs.rs/humantime-serde
|
||
|
|
|
||
|
|
License
|
||
|
|
=======
|
||
|
|
|
||
|
|
Licensed under either of
|
||
|
|
|
||
|
|
* Apache License, Version 2.0, (./LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
|
||
|
|
* MIT license (./LICENSE-MIT or http://opensource.org/licenses/MIT)
|
||
|
|
|
||
|
|
at your option.
|
||
|
|
|
||
|
|
Contribution
|
||
|
|
------------
|
||
|
|
|
||
|
|
Unless you explicitly state otherwise, any contribution intentionally
|
||
|
|
submitted for inclusion in the work by you, as defined in the Apache-2.0
|
||
|
|
license, shall be dual licensed as above, without any additional terms or
|
||
|
|
conditions.
|