Enum Period 

pub enum Period {
    Year(i32),
    Half(i32, u8),
    Quarter(i32, u8),
    Month(i32, u8),
    Week(i32, u8),
    Rolling(u32, NaiveDate),
}

A named time window with period-over-period semantics.

Variants

Year(i32)

Half(i32, u8)

Quarter(i32, u8)

Month(i32, u8)

Week(i32, u8)

Rolling(u32, NaiveDate)

Last N days ending on a date.

Implementations

impl Period

pub fn to_key(&self) -> String

Canonical key string: 2026, 2026-H1, 2026-Q1, 2026-01, 2026-W02, last-30.

pub fn parse(text: &str) -> Result<Self>

Parse 2026, 2026-H1, 2026-Q1, 2026-01, 2026-M1, 2026-W02, last-N, this-*, previous-*.

pub fn parse_with_reference(text: &str, reference: NaiveDate) -> Result<Self>

Parse with an explicit reference date (testable).

pub fn date_range(&self) -> (NaiveDate, NaiveDate)

Inclusive (start, end) dates of the period.

pub fn previous(&self) -> Period

The immediately preceding period of the same granularity.

pub fn date_column(&self) -> &'static str

Which dim_date column equality-filters this period.

pub fn position_column(&self) -> Option<&'static str>

The positional column for apples-to-apples truncation of the previous period. None for Rolling (always complete).

pub fn days_elapsed(&self, reference: NaiveDate) -> i64

Days elapsed within the period as of a reference date.

pub fn is_partial(&self, reference: NaiveDate) -> bool

Is the period still in progress at the reference date?

pub fn effective_end_date(&self, reference: NaiveDate) -> NaiveDate

The period’s end capped at the reference date.

pub fn column_for_key(key: &str) -> &'static str

Pick the dim_date column for an arbitrary period key string.

Trait Implementations

impl Clone for Period

fn clone(&self) -> Period

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Period

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

Formats the value using the given formatter.

impl PartialEq for Period

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Period