Struct BitemporalRecord 

pub struct BitemporalRecord<T = ()> {
    pub id: RecordId,
    pub valid_time: DateTime<Utc>,
    pub recorded_time: DateTime<Utc>,
    pub value: T,
}

A bitemporal record.

Type parameter T is the domain value being recorded. The record carries two orthogonal timelines:

• valid_time: when the value is true in the domain (business time)
• recorded_time: when the system captured the value (system time)

Fields

id: RecordId

Unique identifier for this record (stable across versions). Used to link superseding records.

valid_time: DateTime<Utc>

Valid time — when this record’s value is true in the domain. Backward-bounded (valid_time is set to the moment the fact became true).

recorded_time: DateTime<Utc>

Recorded time — when this record was inserted into the system. Forward-bounded (recorded_time is the moment of system insertion).

value: T

The domain value this record captures. Defaults to T::default() when missing from the wire format — both with and without the schema feature. The schema feature adds T: Default to the schemars bound, which is also the bound serde(default) requires.

Implementations

impl<T> BitemporalRecord<T>

pub fn map<U>(self, f: impl FnOnce(T) -> U) -> BitemporalRecord<U>

Map the value of this record through a function, preserving temporal fields.

pub fn id(&self) -> &str

Returns the record’s ID.

pub fn valid_time(&self) -> DateTime<Utc>

Returns the valid time (when the value is true in the domain).

pub fn recorded_time(&self) -> DateTime<Utc>

Returns the recorded time (when the system captured this).

Trait Implementations

impl<T: Clone> Clone for BitemporalRecord<T>

fn clone(&self) -> BitemporalRecord<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for BitemporalRecord<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for BitemporalRecord<T>

where T: Deserialize<'de> + Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: PartialEq> PartialEq for BitemporalRecord<T>

fn eq(&self, other: &BitemporalRecord<T>) -> 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<T> Serialize for BitemporalRecord<T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq> Eq for BitemporalRecord<T>

impl<T> StructuralPartialEq for BitemporalRecord<T>