Struct AbstractTemporalExpression 

pub struct AbstractTemporalExpression {
    pub text: String,
    pub expression_type: TemporalExpressionType,
    pub granularity: TemporalGranularity,
    pub grounded_range: Option<(DateTime<Utc>, DateTime<Utc>)>,
    pub grounding_confidence: f64,
    pub requires_context: bool,
}

An abstract temporal expression with full metadata.

This is the temporal analog to abstract entities in a hierarchical clustering layer - it captures not just when something happened, but how precisely we know when, and what kind of temporal reference it is.

Fields

text: String

Original text of the temporal expression

expression_type: TemporalExpressionType

Type of temporal expression

granularity: TemporalGranularity

Granularity level

grounded_range: Option<(DateTime<Utc>, DateTime<Utc>)>

Grounded time range (if resolvable) For “January 2024”, this would be (2024-01-01, 2024-01-31)

grounding_confidence: f64

Confidence in the grounding (0.0 to 1.0)

requires_context: bool

Whether this requires external context to resolve

Implementations

impl AbstractTemporalExpression

pub fn absolute( text: impl Into<String>, granularity: TemporalGranularity, ) -> AbstractTemporalExpression

Create a new absolute temporal expression.

pub fn relative( text: impl Into<String>, offset_days: i32, ) -> AbstractTemporalExpression

Create a relative temporal expression.

pub fn fuzzy( text: impl Into<String>, direction: FuzzyDirection, ) -> AbstractTemporalExpression

Create a fuzzy temporal expression.

pub fn ground( &self, document_date: &DateTime<Utc>, ) -> Option<AbstractTemporalExpression>

Ground this expression relative to a document date.

For relative expressions like “yesterday”, this resolves to an absolute time.

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

Check if this expression overlaps with another.

pub fn midpoint(&self) -> Option<DateTime<Utc>>

Get the midpoint of this temporal expression (if grounded).

Trait Implementations

impl Clone for AbstractTemporalExpression

fn clone(&self) -> AbstractTemporalExpression

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AbstractTemporalExpression

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AbstractTemporalExpression

fn deserialize<__D>( __deserializer: __D, ) -> Result<AbstractTemporalExpression, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AbstractTemporalExpression

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

where __S: Serializer,

Serialize this value into the given Serde serializer.