Struct TimeRange 

pub struct TimeRange {
    pub start: Timestamp,
    pub end: Timestamp,
}

Time range for temporal queries.

Represents a span of time with start and end timestamps.

Examples

use spatial_narrative::core::{TimeRange, Timestamp};

// Create a range for March 2024
let march = TimeRange::month(2024, 3);

// Check if a timestamp is within range
let ts = Timestamp::parse("2024-03-15T12:00:00Z").unwrap();
assert!(march.contains(&ts));

Fields

start: Timestamp

Start of the range (inclusive).

end: Timestamp

End of the range (inclusive).

Implementations

impl TimeRange

pub fn new(start: Timestamp, end: Timestamp) -> Self

Creates a new time range.

pub fn year(year: i32) -> Self

Creates a time range for a specific year.

pub fn month(year: i32, month: u32) -> Self

Creates a time range for a specific month.

pub fn day(year: i32, month: u32, day: u32) -> Self

Creates a time range for a specific day.

pub fn last(duration: Duration) -> Self

Creates a time range from now going back by the given duration.

pub fn next(duration: Duration) -> Self

Creates a time range from now going forward by the given duration.

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

Checks if a timestamp is within this range.

pub fn overlaps(&self, other: &TimeRange) -> bool

Checks if this range overlaps with another.

pub fn intersection(&self, other: &TimeRange) -> Option<TimeRange>

Returns the intersection of two ranges, if any.

pub fn union(&self, other: &TimeRange) -> TimeRange

Returns a range that spans both this and another range.

pub fn duration(&self) -> Duration

Returns the duration of this range.

pub fn split(&self, chunk_duration: Duration) -> Vec<TimeRange>

Splits the range into smaller ranges of the given duration.

Trait Implementations

impl Clone for TimeRange

fn clone(&self) -> TimeRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeRange

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TimeRange

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TimeRange

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TimeRange

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for TimeRange

impl StructuralPartialEq for TimeRange