Struct Date 

pub struct Date {
    pub year: i32,
    pub month: u8,
    pub day: u8,
}

Gregorian calendar date (proleptic).

This is independent of any time zone; think “calendar day in UTC”.

Fields

year: i32

month: u8

day: u8

Implementations

impl Date

pub fn from_ymd(year: i32, month: u8, day: u8) -> Result<Self, DateError>

Construct a date, validating year/month/day.

pub const fn from_ymd_unchecked(year: i32, month: u8, day: u8) -> Self

Construct a date with minimal checking; debug-only asserts.

Panics in debug builds if the date is invalid.

pub fn from_days_since_unix_epoch(days: i64) -> Result<Self, DateError>

Ben Joffe’s fast 64-bit days→date algorithm, adapted to Rust.

days is days since Unix epoch:

• 1970-01-01 => 0
• 1969-12-31 => -1

pub fn days_since_unix_epoch(self) -> i64

Convert to days since Unix epoch (1970-01-01 = 0).

This uses Howard Hinnant’s well-known constant-time civil→days algorithm, which is exact for the proleptic Gregorian calendar.

pub fn weekday(self) -> Weekday

Day of week (Monday = 1).

Unix epoch 1970-01-01 was a Thursday, so we just offset.

pub fn ordinal(self) -> u16

Day of year, 1..=365 (or 366 for leap years).

pub fn add_days(self, days: i64) -> Result<Date, DateError>

Add a number of days, returning a new Date or OutOfRange.

Trait Implementations

impl Clone for Date

fn clone(&self) -> Date

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Date

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

Formats the value using the given formatter.

impl Display for Date

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

Formats the value using the given formatter.

impl FromStr for Date

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

Parse “YYYY-MM-DD” (no timezone).

type Err = DateError

The associated error which can be returned from parsing.

impl Hash for Date

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 PartialEq for Date

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

Tests for self and other values to be equal, and is used by ==.

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 Copy for Date

impl Eq for Date

impl StructuralPartialEq for Date