Struct DateTime 

pub struct DateTime {
    pub year: u16,
    pub month: u8,
    pub day: u8,
    pub hour: u8,
    pub minute: u8,
    pub second: u8,
    pub tz_offset_minutes: i16,
}

Date-time with timezone offset preserved.

References

• RFC 5322 Section 3.3 (date-time specification)

Fields

year: u16

Year (e.g., 2025).

month: u8

Month (1–12).

day: u8

Day of month (1–31).

hour: u8

Hour (0–23).

minute: u8

Minute (0–59).

second: u8

Second (0–59).

tz_offset_minutes: i16

Timezone offset from UTC in minutes (e.g., +0530 → 330, −0800 → −480).

Implementations

impl DateTime

pub fn to_unix_timestamp(&self) -> i64

Converts this date-time to a Unix timestamp (seconds since 1970-01-01T00:00:00Z).

The timezone offset is applied so the result is always UTC-based. Uses the same civil-to-days algorithm as the builder.

References

• RFC 5322 Section 3.3

pub fn from_unix_timestamp(timestamp: i64, tz_offset_minutes: i16) -> Self

Creates a DateTime from a Unix timestamp (seconds since epoch) and a timezone offset in minutes.

References

• RFC 5322 Section 3.3

pub fn now() -> Self

Returns the current UTC time as a DateTime.

References

• RFC 5322 Section 3.3

pub fn weekday(&self) -> u8

Returns the day of week for this date.

Returns 0 for Sunday, 1 for Monday, …, 6 for Saturday.

References

• RFC 5322 Section 3.3

pub fn to_rfc5322_string(&self) -> String

Formats this date-time as an RFC 5322 date-time string.

Produces the format: day-of-week, DD Mon YYYY HH:MM:SS ±HHMM (e.g., "Thu, 13 Feb 2025 15:47:33 +0000").

References

• RFC 5322 Section 3.3

pub fn to_iso8601_string(&self) -> String

Formats this date-time as an ISO 8601 / RFC 3339 string.

Produces the format: YYYY-MM-DDTHH:MM:SS±HH:MM (e.g., "2025-02-13T15:47:33+00:00").

This format is widely used in JSON APIs and structured data exchange.

References

• ISO 8601 (date-time representation)
• RFC 3339 (date-time on the Internet)

pub fn parse_rfc5322(input: &str) -> Option<Self>

Parses an RFC 5322 date-time string into a DateTime.

Accepts: [day-of-week ","] day month year hour ":" minute [":" second] zone

Strips CFWS (comments and folding white space) before parsing, as allowed by the obsolete date syntax (RFC 5322 Section 4.3).

Returns None if the input is not a valid RFC 5322 date-time.

References

• RFC 5322 Section 3.3
• RFC 5322 Section 4.3 (obsolete syntax)

Trait Implementations

impl Clone for DateTime

fn clone(&self) -> DateTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DateTime

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

Formats the value using the given formatter.

impl Display for DateTime

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

Formats the value using the given formatter.

impl FromStr for DateTime

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses an RFC 5322 date-time string into a DateTime.

Accepts: [day-of-week ","] day month year hour ":" minute [":" second] zone

This enables the ergonomic "Thu, 13 Feb 2025 15:47:33 +0000".parse::<DateTime>() pattern via the standard FromStr trait.

References

• RFC 5322 Section 3.3
• RFC 5322 Section 4.3 (obsolete syntax)

type Err = Error

The associated error which can be returned from parsing.

impl Hash for DateTime

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

Hashes by UTC-normalized timestamp, consistent with Eq and Ord.

Two DateTime values representing the same UTC instant (but with different timezone offsets) will produce the same hash, matching the Eq behavior.

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 DateTime

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

Compares two DateTime values by their UTC-normalized timestamps.

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.

impl PartialEq for DateTime

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

Compares two DateTime values by their UTC-normalized timestamps, consistent with the Ord implementation.

References

• RFC 5322 Section 3.3 (date-time specification)

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for DateTime

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 Eq for DateTime