Struct Date 

pub struct Date { /* private fields */ }

Indicates the date.

Used for the nightly versions of rust.

The timezone is not explicitly specified here, and matches whatever one the rust team uses for nightly releases.

Implementations

impl Date

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

Create a date, using YYYY-MM-DD format (ISO 8601).

Panics

May panic if the date is invalid. See Self::try_new for a version that returns an error instead.

Examples

let x = Date::new(2018, 10, 21);
let y = Date::new(2017, 11, 30);
assert!(x.is_since(y));
assert!(x.is_since(x));

pub fn try_new( year: u32, month: u32, day: u32, ) -> Result<Self, DateValidationError>

Create a date, using YYYY-MM-DD format (ISO 8601).

Errors

Returns an error if the date is obviously invalid. However, this validation may have false negatives. See Self::new for a version that panics instead.

pub fn is_since(&self, start: Date) -> bool

Check if this date is later than or equal to the specified start.

Equivalent to self >= start, but potentially clearer.

Example

assert!(Date::new(2024, 11, 16).is_since(Date::new(2024, 7, 28)));

pub fn is_before(&self, end: Date) -> bool

Check if this date is before the specified end.

Equivalent to self < end, but potentially clearer.

Example

assert!(Date::new(2018, 12, 14).is_before(Date::new(2022, 8, 16)));
assert!(Date::new(2024, 11, 14).is_before(Date::new(2024, 12, 7)));
assert!(Date::new(2024, 11, 14).is_before(Date::new(2024, 11, 17)));

pub fn year(&self) -> u32

The year (AD/CE), in the range 1..

pub fn month(&self) -> u32

The month of the year, in the range 1..=12.

pub fn day(&self) -> u32

The day of the year, in the range 1..=31.

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

Displays the date consistent with the ISO 8601 standard.

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

Formats the value using the given formatter.

impl FromStr for Date

type Err = DateParseError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

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