Struct DocDate 

pub struct DocDate {
    pub year: u32,
    pub month: u32,
    pub day: u32,
}

A calendar date as an ADR writes one: YYYY-MM-DD, in a frontmatter last-modified: field or a version-history row’s Date cell.

Three u32s rather than a chrono type because the only thing asked of it is ordering, and ISO-8601 components compare correctly component-wise — the same reason DocVersion is a pair of numbers. Adding a date library to compare two strings the parser has already split would be the larger change.

Nothing here validates that a date exists: 2026-02-31 parses. A check that refused impossible dates would be a different rule with a different failure mode, and the rules that consume this only ever ask which of two dates is later.

Fields

year: u32

Four-digit year.

month: u32

Month, 1..=12 as written — unvalidated.

day: u32

Day, as written — unvalidated.

Implementations

impl DocDate

pub fn parse(s: &str) -> Option<Self>

Parse a string that is exactly YYYY-MM-DD — four digits, two, two. Anything else is None, which is how a TBD, an empty cell or a prose date is skipped rather than guessed at.

Fixed width is the contract, not an accident. A looser split would accept 2026-8-1, and Display would then render it back as 2026-08-01 — so a violation message would quote a date the document does not contain. A gate that reports what a file says has to say what the file says.

The cost of the strictness is that a hand-typed 2026-8-1 reads as no date claim rather than as a date, exactly as TBD does. That is the same trade every other cell in this column already makes, and it is the safe direction: the rules that consume a date only ever report a contradiction, so a skipped cell loses a finding while a guessed one invents one. Every date across this repository’s twenty ADRs is zero-padded, and roteiro spec generates the frontmatter field, so nothing today is affected either way.

Trait Implementations

impl Clone for DocDate

fn clone(&self) -> DocDate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DocDate

impl Debug for DocDate

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

Formats the value using the given formatter.

impl Display for DocDate

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

Formats the value using the given formatter.

impl Eq for DocDate

impl Ord for DocDate

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

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for DocDate

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