Struct Span 

pub struct Span {
    pub window: Window,
    pub start: Option<Timestamp>,
    pub end: Timestamp,
    pub reckoned_in: Option<TimeZone>,
    pub horizon: Timestamp,
}

A resolved Window: two instants, and an honest account of how they were arrived at.

Fields

window: Window

The window this came from.

start: Option<Timestamp>

When the period starts. None means “from the beginning of what is kept”.

end: Timestamp

When the period ends, which is the moment it was resolved.

reckoned_in: Option<TimeZone>

The zone the start was reckoned in, or None for a rolling window.

horizon: Timestamp

The oldest instant retention still keeps.

Implementations

impl Span

pub fn contains(&self, at: Timestamp) -> bool

Returns true when at falls inside the period.

Half-open: the start is included and the end is not, so consecutive windows tile without counting a run at the boundary twice.

pub fn truncated_by_retention(&self) -> bool

Returns true when the period reaches further back than retention keeps.

A total over such a window is a lower bound, not a total, and saying so is the same principle that makes crate::cost::CostSource a field: a number whose provenance is unstated will eventually be trusted more than it deserves.

pub fn zone_name(&self) -> Option<&str>

The name of the zone the start was reckoned in, when one was needed.

pub fn duration_secs(&self) -> Option<i64>

How long the period is, in whole seconds, or None for an open start.

Trait Implementations

impl Clone for Span

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 Span

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

Formats the value using the given formatter.

impl Eq for Span

impl PartialEq for Span

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Span