Struct TimeTotal 

pub struct TimeTotal {
    pub filter: TimeFilter,
    pub group: TimeGroup,
    pub total_minutes: Option<i128>,
    pub entry_count: usize,
    pub malformed_count: usize,
    pub undated_count: usize,
    pub deleted_count: Option<usize>,
    pub diagnostics: Vec<TimeDiagnostic>,
}

A typed integer-minute aggregate for one scope (data-model §4).

Every number beside the total is a count a reader needs to know whether the total is the whole story: how many entries were counted, how many were malformed (excluded from the total, each with a finding), how many the period could not place because they carry no date, and — only when the filter asked for audit context — how many prior values a deletion left in History.

Fields

filter: TimeFilter

The selector this total was evaluated under (data-model §4’s scope).

group: TimeGroup

The dimension this total is grouped by.

total_minutes: Option<i128>

The sum of the counted entries’ minutes. None when nothing was counted; Some(0) only when a zero was actually recorded.

entry_count: usize

Valid entries counted into the sum.

malformed_count: usize

Entries whose own fields are unusable. They contribute no number, and each has its own finding.

undated_count: usize

Valid entries a period-bounded filter could not place because they carry no date. Their value is unknown to the period, never zero (C-005).

deleted_count: Option<usize>

Prior values deletions left in History on the issues this total is about. Some only when the filter asked for audit context (T017), and never part of the sum.

The set counted is the scope’s own: an ungrouped total counts the issues the filter’s selector covers, which is exactly what TimeSnapshot::audit reports for the same filter — so an issue whose current entries were all deleted still reports the values History keeps, never a zero; a per-issue group counts its issue; an identity or date group counts the issues its entries were drawn from, because History’s prior values are not re-parsed here and a deletion cannot be attributed to an identity or a date.

diagnostics: Vec<TimeDiagnostic>

Every finding, scope findings first, then per entry in index order (T016).

Implementations

impl TimeTotal

pub fn state(&self) -> TimeTotalState

The explicit state of this total (T015).

pub const fn is_partial(&self) -> bool

Whether some selected entry was left out of the sum (T015).

True when a malformed entry contributed no number, and when a period-bounded scope selected a valid entry it could not place: in both cases the total is not the whole story, and a reader must be shown the counts and findings before the number means anything.

Trait Implementations

impl Clone for TimeTotal

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 TimeTotal

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

Formats the value using the given formatter.

impl Eq for TimeTotal

impl PartialEq for TimeTotal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TimeTotal