Struct Date 

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

A calendar date with year, month, and day components.

Represents the date portion of a TOML datetime value. Field ranges are validated during parsing:

• year: 0–9999
• month: 1–12
• day: 1–31 (upper bound depends on month and leap year rules)

Examples

use toml_spanner::{Arena, DateTime};

let dt: DateTime = "2026-03-15".parse().unwrap();
let date = dt.date().unwrap();
assert_eq!(date.year, 2026);
assert_eq!(date.month, 3);
assert_eq!(date.day, 15);

Fields

year: u16

Calendar year (0–9999).

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) -> Option<Date>

Builds a Date from its year, month, and day components.

Returns None when the values fall outside the TOML calendar range:

• year in 0..=9999
• month in 1..=12
• day in the range of the given month, accounting for leap years

Examples

use toml_spanner::Date;

assert!(Date::new(2024, 2, 29).is_some());
assert!(Date::new(2023, 2, 29).is_none());
assert!(Date::new(10000, 1, 1).is_none());

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

impl Debug for Date

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

Formats the value using the given formatter.

impl Eq for Date

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