Struct Date 

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

A simple date in the Gregorian calendar without time zone information.

Fields

year: u16

The year as commonly used in a date.

The range of 2000 to 2099 is guaranteed to be supported by all methods. For support beyond this range, consult the documentation of the respective implementation.

month: u8

Month of the year [1-12].

day: u8

Day of the month [1-31].

Implementations

impl Date

pub fn new(year: u16, month: u8, day: u8) -> Self

Create a new Date from year, month and day.

No checks will be performed to validate the date.

pub fn new_checked(year: u16, month: u8, day: u8) -> Option<Self>

Create a new Date from year, month and day.

Returns None if the year, month or day is invalid.

The year must be between 2000 and 2199. This range might be extended in the future if the implementation supports it.

pub fn is_valid(self) -> bool

Determine whether the date is a valid combination of year, month and day.

This is guaranteed to work for the years between 2000 and 2199, inclusive.

Years outside of this range will return arbitrary results or may panic.

pub fn is_leap_year(self) -> bool

Helper function to determine whether a given year is a leap year.

This is guaranteed to work for the years between 2000 and 2199.

Years outside of this range will return arbitrary results or may panic.

pub fn with_time(self, time: Time) -> DateTime

Create a new DateTime from a Date and a Time.

Returns None if the hours, minutes or seconds is invalid.

pub fn year2000(self) -> u8

Returns the year relative to 2000.

This is guaranteed to work for the years between 2000 and 2255, inclusive.

The purpose of this method is to obtain a year with reduced width for cheaper calculations. Subtracting 2000 preserves the leap year pattern.

Years outside of this range will return arbitrary results or may panic.

pub fn weekday(self) -> Weekday

Returns the weekday of the date.

This is guaranteed to work for all valid dates within the years 2000 to 2171.

Invalid dates will return arbitrary results or may panic.

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

fn cmp(&self, other: &Date) -> 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.

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

fn partial_cmp(&self, other: &Date) -> 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 Copy for Date

impl Eq for Date

impl StructuralPartialEq for Date