Struct TemporalValidity 

pub struct TemporalValidity {
    pub from: Option<HistoricalDate>,
    pub until: Option<HistoricalDate>,
}

Temporal validity range for an entity.

Represents the time period during which an entity reference is valid. Essential for historical document disambiguation.

Use Cases

• People: birth to death dates
• Organizations: founding to dissolution
• Positions: term start to term end
• Events: start to end time

Examples

use anno_core::types::{HistoricalDate, TemporalValidity};

// Julius Caesar: 100 BCE - 44 BCE
let caesar = TemporalValidity {
    from: Some(HistoricalDate::bce(100, 7, 12)),
    until: Some(HistoricalDate::bce(44, 3, 15)),
};

// Check if entity was valid at a given date
let query = HistoricalDate::bce(50, 1, 1);
assert!(caesar.is_valid_at(&query));

Fields

from: Option<HistoricalDate>

Start of validity (None = unknown/always)

until: Option<HistoricalDate>

End of validity (None = still valid/unknown)

Implementations

impl TemporalValidity

pub fn new( from: Option<HistoricalDate>, until: Option<HistoricalDate>, ) -> TemporalValidity

Create a validity range.

pub fn always() -> TemporalValidity

Create an always-valid range (no temporal constraints).

pub fn from_date(date: HistoricalDate) -> TemporalValidity

Create a range that started at a date and is still valid.

pub fn until_date(date: HistoricalDate) -> TemporalValidity

Create a range that ended at a date.

pub fn is_valid_at(&self, date: &HistoricalDate) -> bool

Check if the entity is valid at a given date.

Returns true if the date falls within the validity range. Unknown bounds (None) are treated as unbounded.

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

Check if this range overlaps with another.

pub fn is_current(&self) -> bool

Check if this entity is currently valid (no end date).

pub fn compatibility_score(&self, document_date: &HistoricalDate) -> f64

Compute temporal compatibility score for entity linking.

Returns a score in [0.0, 1.0] based on how well the document date matches the entity’s validity period.

• 1.0: Document date is within validity period
• 0.5-0.9: Document date is close to validity period
• 0.1-0.5: Document date is far from validity period

Trait Implementations

impl Clone for TemporalValidity

fn clone(&self) -> TemporalValidity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TemporalValidity

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

Formats the value using the given formatter.

impl Default for TemporalValidity

fn default() -> TemporalValidity

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TemporalValidity

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for TemporalValidity

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

Formats the value using the given formatter.

impl Hash for TemporalValidity

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TemporalValidity

fn eq(&self, other: &TemporalValidity) -> 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 TemporalValidity

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.

impl Eq for TemporalValidity

impl StructuralPartialEq for TemporalValidity