Struct HttpDate 

pub struct HttpDate { /* private fields */ }

A point in time with one-second resolution, from year 1 to year 9999, UTC; the value of HTTP-date fields (Date, Last-Modified, Expires).

Examples

use parse_net::HttpDate;

let d = HttpDate::from_unix(0)?;
assert_eq!(&d.format(), b"Thu, 01 Jan 1970 00:00:00 GMT");
assert!(HttpDate::from_unix(HttpDate::MAX.unix() + 1).is_err());

Implementations

impl HttpDate

pub const MIN: Self

0001-01-01T00:00:00Z.

pub const MAX: Self

9999-12-31T23:59:59Z.

pub const fn from_unix(secs: i64) -> Result<Self, ParseError>

The date secs seconds after the Unix epoch (negative before 1970).

Errors

ErrorKind::OutOfRange outside years 1 to 9999.

pub const fn unix(self) -> i64

Seconds since the Unix epoch.

pub fn civil(self) -> Civil

The broken-down UTC time.

pub fn format(self) -> [u8; 29]

The IMF-fixdate text, Sun, 06 Nov 1994 08:49:37 GMT.

pub fn write_to(self, out: &mut impl Sink) -> Result<(), WriteError>

Writes format into out.

Errors

WriteError::Full.

pub fn parse_imf_fixdate(value: &[u8]) -> Result<Self, ParseError>

Parses exactly an IMF-fixdate (29 bytes after OWS), the only format senders may generate. Needs no clock.

Errors

ErrorKind::InvalidDate, ErrorKind::WeekdayMismatch, ErrorKind::OutOfRange (year 0000), ErrorKind::TrailingData.

pub fn parse_at(value: &[u8], now: i64) -> Result<Self, ParseError>

Parses an HTTP-date in any of its three formats.

The RFC 850 two-digit year is resolved against now (Unix seconds): a date more than 50 years after now is taken as the most recent past year with the same last two digits, and a date 50 years or more before now moves forward a century, so the year lands in the hundred years around now. Names are case-sensitive, only GMT is accepted, and the weekday must agree with the date.

Errors

ErrorKind::InvalidDate, ErrorKind::WeekdayMismatch, ErrorKind::OutOfRange, ErrorKind::TrailingData.

pub fn parse_at_with( value: &[u8], now: i64, limits: &Limits, ) -> Result<Self, ParseError>

As parse_at, with Limits::allow_leap_second taken from limits.

Errors

As parse_at.

pub fn parse_detailed( value: &[u8], now: i64, ) -> Result<(Self, DateFormat), ParseError>

As parse_at, also reporting the format seen.

Errors

As parse_at.

Examples

use parse_net::{DateFormat, HttpDate};

let (_, fmt) = HttpDate::parse_detailed(b"Sunday, 06-Nov-94 08:49:37 GMT", 1_792_540_800)?;
assert_eq!(fmt, DateFormat::Rfc850);

pub fn now() -> Self

Available on crate feature std only.

The current time from the system clock, clamped to the supported range.

pub fn from_system_time(t: SystemTime) -> Result<Self, ParseError>

Available on crate feature std only.

The date of a SystemTime, truncated to whole seconds toward the past.

Errors

ErrorKind::OutOfRange outside years 1 to 9999.

pub fn to_system_time(self) -> Option<SystemTime>

Available on crate feature std only.

The date as a SystemTime, or None when the platform’s clock type cannot represent it (Windows cannot go before the year 1601).

Trait Implementations

impl Clone for HttpDate

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for HttpDate

impl Debug for HttpDate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for HttpDate

impl Hash for HttpDate

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for HttpDate

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for HttpDate

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for HttpDate

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for HttpDate