Struct TimeFilter 

pub struct TimeFilter {
    pub issue: Option<u32>,
    pub assignee: Option<String>,
    pub date_from: Option<String>,
    pub date_to: Option<String>,
    pub include_deleted: bool,
}

The normalized, read-only issue/assignee/period selector (data-model §3).

Every field is optional and every named one is required to match — the AND rule above. Self::include_deleted is the one field that selects nothing: it is the explicit audit context, and it only ever widens what is reported about the entries the other criteria already selected, never what is summed (T017).

The assignee criterion names the identity that did the work — the entry’s author — because that is the one identity a time entry carries (data-model §1). The issue’s own assignee is ownership, and this read-only module does not filter on it, so a time operation can never appear to change who owns the issue (C-008).

Fields

issue: Option<u32>

The stable issue number to select, or None for every issue.

assignee: Option<String>

The identity that did the work, or None for every identity.

date_from: Option<String>

The inclusive lower calendar bound, YYYY-MM-DD.

date_to: Option<String>

The inclusive upper calendar bound, YYYY-MM-DD.

include_deleted: bool

Whether to report the deleted entries History retains (audit context).

Implementations

impl TimeFilter

pub const fn new() -> Self

A filter with no criteria: it selects every entry.

pub fn for_issue(self, number: u32) -> Self

Select one issue by its stable number.

pub fn for_assignee(self, assignee: impl Into<String>) -> Self

Select the entries one identity did.

pub fn since(self, date: impl Into<String>) -> Self

Bound the period from below, inclusively.

pub fn until(self, date: impl Into<String>) -> Self

Bound the period from above, inclusively.

pub fn between(self, start: impl Into<String>, end: impl Into<String>) -> Self

Bound the period on both sides, inclusively.

pub fn including_deleted(self) -> Self

Report the deleted entries History retains, too (audit context, T017).

pub const fn is_unfiltered(&self) -> bool

Whether the filter names no criterion at all.

pub const fn has_period(&self) -> bool

Whether the filter names a calendar period.

pub fn problems(&self) -> Vec<TimeFilterError>

Every reason the filter cannot be used as written, in field order; empty means valid.

The bounds are checked with the crate’s calendar validator and the assignee with the crate’s identity parser, so “valid” here means the same thing it means everywhere else. An inverted period is only reported when both bounds are themselves valid: reporting both a bad bound and an inversion derived from it would name one mistake twice.

pub fn validate(&self) -> Result<(), Vec<TimeFilterError>>

Refuse the filter unless every criterion is usable.

pub fn is_valid(&self) -> bool

Whether every criterion is usable.

pub fn canonical_assignee(&self) -> Option<String>

The assignee criterion in canonical identity form, resolved once.

What Self::selects compares against, and what an aggregation should resolve once instead of re-parsing per entry (T014).

pub fn place(&self, date: Option<&str>) -> PeriodPlacement

Where date falls relative to this filter’s period (T013).

A filter that names no bounds places every date in the period, including an entry with no date and an entry whose date is unreadable: with no period there is nothing to fail to place, and the entry’s own problems are reported by the aggregation that reads its fields.

The bounds are assumed readable — Self::problems is checked before any aggregation, and Self::selects refuses an invalid filter outright. A malformed bound is never read here, so it can never be mistaken for “no bound” by a caller that validated its filter.

pub fn selects(&self, issue: u32, entry: &TimeEntry) -> bool

Whether one entry of one issue is selected by the whole predicate.

The AND rule, in one place: the issue criterion, then the assignee criterion, then the period placement. An invalid criterion selects nothing rather than being skipped: an unreadable bound must not behave as no bound and a blank identity must not match every author, because both would read a mistake as a wider scope than the caller asked for. Self::problems is where the reason is reported. For a pass over many entries resolve Self::canonical_assignee once instead: this convenience canonicalizes the criterion per call.

pub fn describe(&self) -> String

A short label for the scope, for a heading or a payload (C-006).

One spelling for every surface: issue #3, assignee @ada, period 2026-03-01..2026-03-31, audit, joined by , , or all when the filter names nothing.

Trait Implementations

impl Clone for TimeFilter

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeFilter

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

Formats the value using the given formatter.

impl Default for TimeFilter

fn default() -> Self

Returns the “default value” for a type.

impl Display for TimeFilter

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

Formats the value using the given formatter.

impl Eq for TimeFilter

impl PartialEq for TimeFilter

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TimeFilter