Struct ReleaseDate 

pub struct ReleaseDate { /* private fields */ }

A spec revision’s release date.

Ordered chronologically: the derived comparison walks year, then month, then day, which is the only ordering in which those three fields compose correctly. Nothing else may be derived from the ordering, so the Ord and PartialOrd pair below comes from that same field order and tests::derived_ordering_agrees_in_both_directions pins the two together.

Implementations

impl ReleaseDate

pub const V2024_11_05: Self

The first published revision, 2024-11-05.

Also the floor for ProtocolVersion::from_str: a well-formed date before this one names a revision that predates the protocol, which is a parse error rather than an unknown revision.

pub const V2025_03_26: Self

The 2025-03-26 revision.

pub const V2025_06_18: Self

The 2025-06-18 revision.

pub const V2025_11_25: Self

The 2025-11-25 revision.

pub const V2026_07_28: Self

The 2026-07-28 revision, and the newest this build knows.

pub const fn year(self) -> u16

The year, as a four-digit value.

pub const fn month(self) -> u8

The month, 1..=12.

pub const fn day(self) -> u8

The day of the month.

pub fn is_at_or_after_first_revision(self) -> bool

Whether this date is ReleaseDate::V2024_11_05 or later.

The comparison is on the date, not the enum: a date this build has not heard of can still be after the first revision, and forward compatibility depends on that case being reachable.

Not const: the comparison comes from a derived Ord, and a derived Ord is not a const-callable operator.

Trait Implementations

impl Clone for ReleaseDate

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 ReleaseDate

impl Debug for ReleaseDate

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

Formats the value using the given formatter.

impl Display for ReleaseDate

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

Formats the value using the given formatter.

impl Eq for ReleaseDate

impl FromStr for ReleaseDate

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

Parses exactly YYYY-MM-DD.

Every position is checked in order and the first failure is reported, so a string that is both the wrong length and unparseable says so once rather than producing a cascade. Trailing characters are rejected because a version string is a whole token, not a prefix of one.

type Err = ParseReleaseDateError

The associated error which can be returned from parsing.

impl Hash for ReleaseDate

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 ReleaseDate

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 ReleaseDate

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ReleaseDate

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 ReleaseDate