Struct CalendarDate 

pub struct CalendarDate(/* private fields */);

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

A thin wrapper over jiff::civil::Date so the crate’s public surface (and the py/js bindings behind it) keeps its own type. The wrapped crate replaced a hand-rolled proleptic-Gregorian day-number implementation (issue #91); the pinned tests that held that implementation to Python’s datetime now hold jiff to the same 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. jiff’s constant refuses an invalid literal at compile time when const-evaluated, which is strictly better than the old non-validating constructor; 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. The range pre-checks keep the narrowing casts from wrapping (month = 257 must not arrive at jiff as 1).

pub fn from_unix_secs(secs: u64) -> Result<CalendarDate, Error>

The UTC civil day secs seconds after the Unix epoch falls on.

UTC rather than local, and no tzdb: a rate table’s age is measured in ninety-day units, so the zone can only ever move the answer by a day. The time is the caller’s: this crate doesn’t read the clock (ARCH-6), and microvms_core::prelude::CalendarDateExt::today_utc is the one that does.

Refuses a time past 9999-12-31, the last day the calendar holds, rather than clamping it: the likeliest such value is a millisecond count passed as seconds, and an age computed from a clamped or defaulted date would be wrong with no sign.

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.

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

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

Trait Implementations

impl CalendarDateExt for CalendarDate

fn today_utc() -> CalendarDate

Today, UTC, from the system clock.

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<(), Error>

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<(), Error>

Formats the value using the given formatter.

impl Eq for CalendarDate

impl Hash for CalendarDate

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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.

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 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