Enum TemporalValue 

pub enum TemporalValue {
    Date {
        days_since_epoch: i32,
    },
    LocalTime {
        nanos_since_midnight: i64,
    },
    Time {
        nanos_since_midnight: i64,
        offset_seconds: i32,
    },
    LocalDateTime {
        nanos_since_epoch: i64,
    },
    DateTime {
        nanos_since_epoch: i64,
        offset_seconds: i32,
        timezone_name: Option<String>,
    },
    Duration {
        months: i64,
        days: i64,
        nanos: i64,
    },
}

Typed temporal value representation.

Stores temporal values in their native numeric form for O(1) comparisons and direct Arrow column construction, with Cypher formatting applied only at the output boundary via std::fmt::Display.

Variants

Date

Date: days since Unix epoch (1970-01-01). Arrow: Date32.

Fields

days_since_epoch: i32

LocalTime

Local time (no timezone): nanoseconds since midnight. Arrow: Time64(ns).

Fields

nanos_since_midnight: i64

Time

Time with timezone offset: nanoseconds since midnight + offset. Arrow: Time64(ns) + metadata.

Fields

nanos_since_midnight: i64

offset_seconds: i32

LocalDateTime

Local datetime (no timezone): nanoseconds since Unix epoch. Arrow: Timestamp(ns, None).

Fields

nanos_since_epoch: i64

DateTime

Datetime with timezone: nanoseconds since Unix epoch (UTC) + offset + optional tz name. Arrow: Timestamp(ns, Some(“UTC”)).

Fields

nanos_since_epoch: i64

offset_seconds: i32

timezone_name: Option<String>

Duration

Duration with calendar semantics: months + days + nanoseconds. Matches Cypher’s duration model which preserves calendar components.

Fields

months: i64

days: i64

nanos: i64

Implementations

impl TemporalValue

pub fn temporal_type(&self) -> TemporalType

Returns the temporal type classification.

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

Year component, or None for time-only/duration types.

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

Month component (1-12), or None for time-only/duration types.

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

Day-of-month component (1-31), or None for time-only/duration types.

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

Hour component (0-23), or None for date-only types.

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

Minute component (0-59), or None for date-only types.

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

Second component (0-59), or None for date-only types.

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

Millisecond sub-second component (0-999), or None for date-only types.

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

Microsecond sub-second component (0-999_999), or None for date-only types.

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

Nanosecond sub-second component (0-999_999_999), or None for date-only types.

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

Quarter (1-4), or None for time-only/duration types.

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

ISO week number (1-53), or None for time-only/duration types.

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

ISO week year, or None for time-only/duration types.

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

Ordinal day of year (1-366), or None for time-only/duration types.

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

ISO day of week (Monday=1, Sunday=7), or None for time-only/duration types.

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

Day of quarter (1-92), or None for time-only/duration types.

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

Timezone name if available (e.g., “Europe/Stockholm”).

pub fn offset(&self) -> Option<String>

Offset string (e.g., “+01:00”, “Z”).

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

Offset in minutes.

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

Offset in seconds.

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

Epoch seconds (for datetime/localdatetime types).

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

Epoch milliseconds (for datetime/localdatetime types).

pub fn to_date(&self) -> Option<NaiveDate>

Extract a NaiveDate from types that have a date component.

pub fn to_time(&self) -> Option<NaiveTime>

Extract a NaiveTime from types that have a time component.

Trait Implementations

impl Clone for TemporalValue

fn clone(&self) -> TemporalValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TemporalValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TemporalValue

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for TemporalValue

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

Formats the value using the given formatter.

impl Hash for TemporalValue

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

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 TemporalValue

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

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 TemporalValue

impl StructuralPartialEq for TemporalValue