Struct Date

pub struct Date {
    days: i32,
}

A Postgres-compatible Date. Additionally clamp valid dates for the range that chrono supports to allow for safe string operations. Infinite dates are not yet supported.

Fields

days: i32

Number of days from the postgres epoch (2000-01-01).

Implementations

impl Date

pub const UNIX_EPOCH_TO_PG_EPOCH: i32 = 10_957i32

const CE_EPOCH_TO_PG_EPOCH: i32 = 730_120i32

pub const LOW_DAYS: i32 = -2_451_545i32

pub const HIGH_DAYS: i32 = 95_015_279i32

Largest date support by Materialize. Although Postgres can go up to 5874897-12-31, chrono is limited to December 31, 262142, which we mirror here so we can use chrono’s formatting methods and have guaranteed safe conversions.

pub fn from_pg_epoch(days: i32) -> Result<Date, DateError>

Constructs a new Date as the days since the postgres epoch (2000-01-01).

pub fn from_unix_epoch(unix_days: i32) -> Result<Date, DateError>

Constructs a new Date as the days since the Unix epoch.

pub fn pg_epoch_days(&self) -> i32

Returns the number of days since the postgres epoch.

pub fn is_finite(&self) -> bool

Returns whether this is the infinity or -infinity date.

Currently we do not support these, so this function is a light protection against if they are added for functions that will produce incorrect results for these values.

pub fn unix_epoch_days(&self) -> i32

Returns the number of days since the Unix epoch.

pub fn checked_add(self, days: i32) -> Result<Date, DateError>

Returns this date with days added to it.

Trait Implementations

impl<'a> AsColumnType for Date

fn as_column_type() -> ColumnType

The SQL column type of this Rust type

impl Clone for Date

fn clone(&self) -> Date

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, E> DatumType<'a, E> for Date

fn nullable() -> bool

Whether this Rust type can represent NULL values

fn fallible() -> bool

Whether this Rust type can represent errors

fn try_from_result( res: Result<Datum<'a>, E>, ) -> Result<Self, Result<Datum<'a>, E>>

Try to convert a Result whose Ok variant is a Datum into this native Rust type (Self). If it fails the error variant will contain the original result.

fn into_result(self, _temp_storage: &'a RowArena) -> Result<Datum<'a>, E>

Convert this Rust type into a Result containing a Datum, or an error

impl Debug for Date

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Date

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Date

Format an Date in a human form

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

Formats the value using the given formatter.

impl From<&Date> for NaiveDate

fn from(date: &Date) -> Self

Converts to this type from the input type.

impl<'a> From<Date> for Datum<'a>

fn from(d: Date) -> Datum<'a>

Converts to this type from the input type.

impl From<Date> for NaiveDate

fn from(date: Date) -> Self

Converts to this type from the input type.

impl FromStr for Date

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Date

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 Ord for Date

fn cmp(&self, other: &Date) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Date

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

fn partial_cmp(&self, other: &Date) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> RangeOps<'a> for Date

fn step(self) -> Option<Date>

Increment self one step forward, if applicable. Return None if overflows.

fn err_type_name() -> &'static str

fn unwrap_datum(d: Datum<'a>) -> Self

impl RustType<ProtoDate> for Date

fn into_proto(&self) -> ProtoDate

Convert a Self into a Proto value.

fn from_proto(proto: ProtoDate) -> Result<Self, TryFromProtoError>

Consume and convert a Proto back into a Self value.

fn into_proto_owned(self) -> Proto

A zero clone version of Self::into_proto that types can optionally implement, otherwise, the default implementation delegates to Self::into_proto.

impl Serialize for Date

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub for Date

type Output = i32

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl TryFrom<Datum<'_>> for Date

type Error = ()

The type returned in the event of a conversion error.

fn try_from(from: Datum<'_>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<NaiveDate> for Date

type Error = DateError

The type returned in the event of a conversion error.

fn try_from(value: NaiveDate) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Date

impl Eq for Date

impl StructuralPartialEq for Date