rama_http_headers/common/
date.rs

1use std::time::SystemTime;
2
3use rama_core::telemetry::tracing;
4use rama_http_types::HeaderValue;
5
6use crate::util::HttpDate;
7
8/// `Date` header, defined in [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.2)
9///
10/// The `Date` header field represents the date and time at which the
11/// message was originated.
12///
13/// ## ABNF
14///
15/// ```text
16/// Date = HTTP-date
17/// ```
18///
19/// ## Example values
20///
21/// * `Tue, 15 Nov 1994 08:12:31 GMT`
22///
23/// # Example
24///
25/// ```
26/// use rama_http_headers::Date;
27/// use rama_utils::time::now_system_time;
28///
29/// let date = Date::from(now_system_time());
30/// ```
31#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
32pub struct Date(HttpDate);
33
34impl crate::TypedHeader for Date {
35    fn name() -> &'static ::rama_http_types::header::HeaderName {
36        &::rama_http_types::header::DATE
37    }
38}
39
40impl crate::HeaderDecode for Date {
41    fn decode<'i, I>(values: &mut I) -> Result<Self, crate::Error>
42    where
43        I: Iterator<Item = &'i ::rama_http_types::header::HeaderValue>,
44    {
45        crate::util::TryFromValues::try_from_values(values).map(Date)
46    }
47}
48
49impl crate::HeaderEncode for Date {
50    fn encode<E: Extend<HeaderValue>>(&self, values: &mut E) {
51        match HeaderValue::try_from(&self.0) {
52            Ok(value) => values.extend(::std::iter::once(value)),
53            Err(err) => {
54                tracing::debug!("failed to encode date value as header: {err}");
55            }
56        }
57    }
58}
59
60impl From<SystemTime> for Date {
61    fn from(time: SystemTime) -> Self {
62        Self(time.into())
63    }
64}
65
66impl From<Date> for SystemTime {
67    fn from(date: Date) -> Self {
68        date.0.into()
69    }
70}
rama_http_headers/common/date.rs

rama_http_headers/common/
date.rs
