quiver_types 0.3.0

Core types for the quiver crate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! [`Date32`] and [`Date64`]: logical types for columns of calendar dates.
//!
//! Each element is a date without a time-of-day or timezone:
//! [`Date32`] counts *days* since the Unix epoch (1970-01-01) as an `i32`,
//! stored as an [`arrow::array::Date32Array`]
//! ([`DataType::Date32`]);
//! [`Date64`] counts *milliseconds* since the epoch as an `i64`
//! (expected to be a multiple of a day; not validated),
//! stored as an [`arrow::array::Date64Array`].

use arrow::array::{Array, ArrayRef};
use arrow::datatypes::DataType;

use crate::datatype::{ColumnError, LogicalType, impl_marker_datatype, impl_primitive_datatype};

/// Days since the Unix epoch, as an `i32`.
///
/// ```
/// use quiver::{Column, Date32};
///
/// let column = Column::<Date32>::from_values([19_876, 19_877]); // days since 1970-01-01
/// assert_eq!(column.value(0), 19_876);
/// ```
///
/// This type is never instantiated — it only appears as a type parameter.
pub struct Date32;

/// Milliseconds since the Unix epoch, as an `i64`
/// (expected to be a multiple of a day; not validated).
///
/// ```
/// use quiver::{Column, Date64};
///
/// let column = Column::<Date64>::from_values([1_717_200_000_000_i64]); // ms since 1970-01-01
/// assert_eq!(column.value(0), 1_717_200_000_000);
/// ```
///
/// This type is never instantiated — it only appears as a type parameter.
pub struct Date64;

impl_marker_datatype!(
    Date32,
    arrow::array::Date32Array,
    i32,
    i32,
    DataType::Date32
);
impl_marker_datatype!(
    Date64,
    arrow::array::Date64Array,
    i64,
    i64,
    DataType::Date64
);

impl_primitive_datatype!(Date32, i32);
impl_primitive_datatype!(Date64, i64);