Struct CalendarDate 

pub struct CalendarDate { /* private fields */ }

A calendar day, which is the only temporal resolution a rate table has.

Deliberately not a dependency. cargo tree shows time 0.3 in this workspace, but only as a transitive dependency of aws-smithy-runtime — taking it here would mean adding a direct dependency, and the module needs exactly two operations: pin a retrieval date, and subtract two dates to get an age in days. No parsing, no formatting, no zones, no arithmetic on months. So the whole date surface is the proleptic-Gregorian day number below, which is twelve lines and has a pinned test against three known values.

Implementations

impl CalendarDate

pub const fn from_ymd(year: i32, month: u32, day: u32) -> CalendarDate

A date from its parts, for the literals in this file.

const so pinned_rates can pin its retrieval date, which is also why it does not validate: a const fn cannot return a Result a caller must handle at compile time. The literals it is used on are pinned by the_pinned_dates_are_real_calendar_days; anything arriving at runtime goes through CalendarDate::try_from_ymd.

pub fn try_from_ymd( year: i32, month: u32, day: u32, ) -> Result<CalendarDate, Error>

A date from parts that came from outside this crate.

The S2 boundary: a --today flag or a JSON field is three integers, and 2026-02-30 would otherwise produce a day number for March 2nd and an age two days out.

pub fn today_utc() -> CalendarDate

Today, UTC.

UTC rather than local, and no dependency: a rate table’s age is measured in ninety-day units, so the zone can only ever move the answer by a day and carrying a timezone database to decide it would be absurd. Falls back to the epoch if the clock is set before 1970, which is a machine whose age arithmetic is already meaningless and is not worth a Result on every report.

pub fn year(self) -> i32

pub fn month(self) -> u32

pub fn day(self) -> u32

pub fn day_number(self) -> i64

Days since 1970-01-01, negative before it.

Howard Hinnant’s days_from_civil, which is the algorithm every date library uses: it shifts the year to start in March so the leap day lands at the end of a year and the month-length pattern becomes the linear (153m + 2) / 5. Correct for every proleptic-Gregorian date, and pinned below against 1970-01-01, a leap day, and this table’s own retrieval date.

pub fn days_since(self, earlier: CalendarDate) -> i64

Days from earlier to self, negative when self is the earlier one.

Trait Implementations

impl Clone for CalendarDate

fn clone(&self) -> CalendarDate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CalendarDate

impl Debug for CalendarDate

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

Formats the value using the given formatter.

impl Display for CalendarDate

ISO 8601, because that is what the Python client’s retrieved.isoformat() puts in the report header and the two have to be diffable.

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

Formats the value using the given formatter.

impl Eq for CalendarDate

impl Hash for CalendarDate

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 CalendarDate

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

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for CalendarDate

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