Struct TemporalArrayV 

pub struct TemporalArrayV {
    pub array: TemporalArray,
    pub offset: usize,
    /* private fields */
}

TemporalArrayView

Read-only, zero-copy view over a [offset .. offset + len) window of a TemporalArray.

Purpose

• Return an indexable subrange without cloning buffers.
• Optionally cache per-window null counts for faster repeated passes.

Behaviour

• Supports 32-bit and 64-bit datetime storage behind TemporalArray.
• Provides upcast helpers - get_i64 and get_i32.
• Further slicing yields another borrowed view.

Fields

• array: backing TemporalArray (enum over temporal types).
• offset: starting index into the backing array.
• len: logical number of elements in the view.
• null_count: cached Option<usize> for this window (internal).

Notes

• Not thread-safe due to Cell. Create per-thread views with slice.
• Use to_temporal_array to materialise the window.

Fields

array: TemporalArray

The outer array that this view is derived from - we retain a reference to it. Importantly, this is the full array - not the view, and thus should not be accessed as though it were the view subset.

offset: usize

The index offset from 0 that for where this view starts from the outer array

Implementations

impl TemporalArrayV

pub fn new(array: TemporalArray, offset: usize, len: usize) -> Self

Creates a new TemporalArrayView with the given offset and length.

pub fn new_nc( array: TemporalArray, offset: usize, len: usize, null_count: usize, ) -> Self

Creates a new TemporalArrayView with a precomputed null count.

pub fn is_empty(&self) -> bool

Returns true if the view is empty.

pub fn get_i64(&self, i: usize) -> Option<i64>

Returns the value at logical index i within the window as i64 (upcasts i32 variant).

pub fn get_i32(&self, i: usize) -> Option<i32>

Returns the value at logical index i as i32 (None for Datetime64).

pub fn slice(&self, offset: usize, len: usize) -> Self

Returns a sliced TemporalArrayView from the current view.

pub fn len(&self) -> usize

Returns the length of the window

pub fn inner_array(&self) -> Array

Returns the full backing array wrapped as an Array enum, ignoring the view’s offset and length.

Use this to access inner array methods. The returned array is the unwindowed original.

pub fn to_temporal_array(&self) -> TemporalArray

Converts the view into an owned TemporalArray for the window.

If the view covers the entire backing array, returns a cheap Arc clone of the original variant. Otherwise deep-copies the window via slice_clone through inner_array.

pub fn end(&self) -> usize

Returns the end index of the view.

pub fn as_tuple(&self) -> (TemporalArray, usize, usize)

Returns the view as a tuple (array, offset, len)

pub fn null_count(&self) -> usize

Returns the number of nulls in the view.

pub fn has_nulls(&self) -> bool

Returns true when the windowed view holds at least one null.

Reads through null_count, so the cached value is trusted when set and the full popcount is only paid on the first call that observes this view.

pub fn null_mask_view(&self) -> Option<BitmaskV>

Returns the null mask as a windowed BitmaskView.

pub fn set_null_count(&self, count: usize) -> Result<(), usize>

Sets the cached null count for the view.

Trait Implementations

impl Clone for TemporalArrayV

fn clone(&self) -> TemporalArrayV

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for TemporalArrayV

fn concat(self, other: Self) -> Result<Self, MinarrowError>

Concatenates two temporal array views by materialising both to owned temporal arrays, concatenating them, and wrapping the result back in a view.

Notes

• This operation copies data from both views to create owned temporal arrays.
• The resulting view has offset=0 and length equal to the combined length.

impl DatetimeOps for TemporalArrayV

Available on crate feature datetime_ops only.

fn year(&self) -> IntegerArray<i32>

Extracts the year component from all datetime values.

fn month(&self) -> IntegerArray<i32>

Extracts the month component (1-12) from all datetime values.

fn day(&self) -> IntegerArray<i32>

Extracts the day of month (1-31) from all datetime values.

fn hour(&self) -> IntegerArray<i32>

Extracts the hour component (0-23) from all datetime values.

fn minute(&self) -> IntegerArray<i32>

Extracts the minute component (0-59) from all datetime values.

fn second(&self) -> IntegerArray<i32>

Extracts the second component (0-59) from all datetime values.

fn weekday(&self) -> IntegerArray<i32>

Extracts the weekday (1=Sunday, 2=Monday, …, 7=Saturday) from all datetime values.

fn day_of_year(&self) -> IntegerArray<i32>

Extracts the day of year (1-366) from all datetime values.

fn iso_week(&self) -> IntegerArray<i32>

Extracts the ISO week number (1-53) from all datetime values.

fn quarter(&self) -> IntegerArray<i32>

Extracts the quarter (1-4) from all datetime values.

fn week_of_year(&self) -> IntegerArray<i32>

Extracts the week of year (0-53) from all datetime values. Week 0 contains days before the first Sunday.

fn is_leap_year(&self) -> BooleanArray<()>

Returns boolean array indicating whether each datetime’s year is a leap year.

fn add_duration(&self, duration: Duration) -> Result<Self, MinarrowError>

Adds a duration to all datetime values in the array.

fn sub_duration(&self, duration: Duration) -> Result<Self, MinarrowError>

Subtracts a duration from all datetime values in the array.

fn add_days(&self, days: i64) -> Result<Self, MinarrowError>

Adds a number of days to all datetime values.

fn add_months(&self, months: i32) -> Result<Self, MinarrowError>

Adds a number of months to all datetime values.

fn add_years(&self, years: i32) -> Result<Self, MinarrowError>

Adds a number of years to all datetime values.

fn diff( &self, other: &Self, unit: TimeUnit, ) -> Result<IntegerArray<i64>, MinarrowError>

Calculate the duration between this datetime array and another. Returns an IntegerArray representing the difference in the specified unit.

fn abs_diff( &self, other: &Self, unit: TimeUnit, ) -> Result<IntegerArray<i64>, MinarrowError>

Calculate the absolute duration between elements (always positive).

fn is_before(&self, other: &Self) -> Result<BooleanArray<()>, MinarrowError>

Compares this array with another, returning a boolean array indicating where values in self are before values in other.

fn is_after(&self, other: &Self) -> Result<BooleanArray<()>, MinarrowError>

Returns a boolean array indicating where values are after other.

fn between( &self, start: &Self, end: &Self, ) -> Result<BooleanArray<()>, MinarrowError>

Returns a boolean array indicating where values fall within the range [start, end].

fn truncate(&self, unit: &str) -> Result<Self, MinarrowError>

Truncate/floor datetime values to the start of the specified unit.

fn us(&self) -> Self

Truncate to microsecond boundaries.

fn ms(&self) -> Self

Truncate to millisecond boundaries.

fn sec(&self) -> Self

Truncate to second boundaries.

fn min(&self) -> Self

Truncate to minute boundaries.

fn hr(&self) -> Self

Truncate to hour boundaries.

fn week(&self) -> Self

Truncate to week boundaries (Sunday 00:00:00).

fn cast_time_unit(&self, new_unit: TimeUnit) -> Result<Self, MinarrowError>

Cast this array to a different TimeUnit.

impl Debug for TemporalArrayV

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

Formats the value using the given formatter.

impl Display for TemporalArrayV

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

Formats the value using the given formatter.

impl From<Array> for TemporalArrayV

fn from(array: Array) -> Self

Converts to this type from the input type.

impl From<ArrayV> for TemporalArrayV

fn from(view: ArrayV) -> Self

Converts an ArrayView to a TemporalArrayView, panicking if the array is not temporal.

impl From<TemporalArray> for TemporalArrayV

fn from(array: TemporalArray) -> Self

Converts to this type from the input type.

impl From<TemporalArrayV> for ArrayV

Available on crate features views and datetime only.

TemporalArrayView -> ArrayView

Converts by wrapping the inner TemporalArray as Array::TemporalArray.

fn from(view: TemporalArrayV) -> Self

Converts to this type from the input type.

impl From<TemporalArrayV> for Value

Available on crate features views and datetime only.

Wrap a TemporalArrayV as Value::ArrayView. The view’s offset and length are preserved; the inner TemporalArray flows through Array::TemporalArray.

fn from(v: TemporalArrayV) -> Self

Converts to this type from the input type.

impl PartialEq for TemporalArrayV

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

fn shape(&self) -> ShapeDim

Returns arbitrary Shape dimension for any data shape

fn shape_1d(&self) -> usize

Returns the first dimension shape

fn shape_2d(&self) -> (usize, usize)

Returns the first and second dimension shapes

fn shape_3d(&self) -> (usize, usize, usize)

Returns the first, second and third dimension shapes

fn shape_4d(&self) -> (usize, usize, usize, usize)

Returns the first, second, third and fourth dimension shapes

impl TryFrom<Value> for TemporalArrayV

Available on crate features views and datetime only.

type Error = MinarrowError

The type returned in the event of a conversion error.

fn try_from(v: Value) -> Result<Self, Self::Error>

Performs the conversion.

impl StructuralPartialEq for TemporalArrayV