mirror of
https://github.com/zerotier/ZeroTierOne.git
synced 2024-12-25 15:41:05 +00:00
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
|
# Date and time utils for HTTP.
|
|||
|
|
|
|||
|
|
[](https://travis-ci.org/pyfisch/httpdate)
|
|||
|
|
[](https://crates.io/crates/httpdate)
|
|||
|
|
[](https://docs.rs/httpdate)
|
|||
|
|
|
|||
|
|
Multiple HTTP header fields store timestamps.
|
|||
|
|
For example a response created on May 15, 2015 may contain the header
|
|||
|
|
`Date: Fri, 15 May 2015 15:34:21 GMT`. Since the timestamp does not
|
|||
|
|
contain any timezone or leap second information it is equvivalent to
|
|||
|
|
writing 1431696861 Unix time. Rust’s `SystemTime` is used to store
|
|||
|
|
these timestamps.
|
|||
|
|
|
|||
|
|
This crate provides two public functions:
|
|||
|
|
|
|||
|
|
* `parse_http_date` to parse a HTTP datetime string to a system time
|
|||
|
|
* `fmt_http_date` to format a system time to a IMF-fixdate
|
|||
|
|
|
|||
|
|
In addition it exposes the `HttpDate` type that can be used to parse
|
|||
|
|
and format timestamps. Convert a sytem time to `HttpDate` and vice versa.
|
|||
|
|
The `HttpType` (8 bytes) is smaller than `SystemTime` (16 bytes) and
|
|||
|
|
using the display impl avoids a temporary allocation.
|
|||
|
|
|
|||
|
|
Read the [blog post](https://pyfisch.org/blog/http-datetime-handling/) to learn
|
|||
|
|
more.
|
|||
|
|
|
|||
|
|
Fuzz it by installing *cargo-fuzz* and running `cargo fuzz run fuzz_target_1`.
|