Struct Date 

pub struct Date { /* private fields */ }

A date value (days since 2000-01-01).

Hyper uses 2000-01-01 as the epoch, which is different from Unix epoch.

Implementations

impl Date

pub const EPOCH_YEAR: i32 = 2000

The Hyper epoch year: 2000

pub const EPOCH_MONTH: u32 = 1

The Hyper epoch month: 1 (January)

pub const EPOCH_DAY: u32 = 1

The Hyper epoch day: 1

pub const JULIAN_DAY_EPOCH: i32 = 2451545

Julian Day Number for 2000-01-01 (the Hyper epoch)

pub const MIN_DAYS: i32

Minimum supported days offset (year 1, Jan 1 relative to 2000-01-01).

pub const MAX_DAYS: i32

Maximum supported days offset (year 9999, Dec 31 relative to 2000-01-01).

pub const MIN_JULIAN_DAY: i32 = 1721060

Minimum supported Julian day (year 1, Jan 1)

pub const MAX_JULIAN_DAY: i32 = 5373484

Maximum supported Julian day (year 9999, Dec 31)

pub const fn from_days(days: i32) -> Date

Creates a Date from days since epoch.

No validation is performed. For a checked variant, use try_from_days.

pub fn try_from_days(days: i32) -> Result<Date, Box<dyn Error + Sync + Send>>

Creates a Date from days since epoch with range validation.

Errors

Returns an error if days falls outside the supported range (years 1-9999, i.e. MIN_DAYS..=MAX_DAYS).

pub fn new(year: i32, month: u32, day: u32) -> Date

Creates a Date from year, month, day components.

Panics

Panics if the date is invalid.

pub const fn days(&self) -> i32

Returns the days since epoch.

pub fn to_ymd(&self) -> (i32, u32, u32)

Returns the year, month, day components.

pub const fn encode(&self) -> u32

Returns the raw encoded value for HyperBinary (Julian Day Number).

Uses wrapping arithmetic to avoid panic for out-of-range days values. Callers should validate dates are within supported range (years 1-9999) before relying on the encoded value.

pub const fn decode(encoded: u32) -> Date

Creates a Date from a raw encoded value (Julian Day Number).

This is an infallible version that does not validate the date range. Use try_decode for validation.

pub fn try_decode(encoded: u32) -> Result<Date, Box<dyn Error + Sync + Send>>

Creates a Date from a raw encoded value (Julian Day Number) with validation.

Returns an error if the date is outside the supported range (years 1-9999) or if the calculation would overflow.

Examples

use hyperdb_api_core::types::Date;

// Valid date
let date = Date::try_decode(2451545).unwrap(); // 2000-01-01

// Invalid date (out of range)
assert!(Date::try_decode(0).is_err());

Errors

• Returns an error if encoded (reinterpreted as i32) falls outside the supported Julian day range Self::MIN_JULIAN_DAY..=Self::MAX_JULIAN_DAY (years 1-9999).
• Returns an error if the day offset from the epoch would overflow i32 or exceed i32::MAX / 2.

pub const fn to_julian_day(&self) -> i32

Returns the Julian Day Number for this date.

Hyper stores dates as Julian Day Numbers (absolute day count).

Uses wrapping arithmetic to avoid panic for out-of-range days values. Callers should validate dates are within supported range (years 1-9999) before relying on the Julian day value.

Trait Implementations

impl Clone for Date

fn clone(&self) -> Date

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Date

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

Formats the value using the given formatter.

impl Display for Date

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

Formats the value using the given formatter.

impl From<NaiveDate> for Date

fn from(d: NaiveDate) -> Date

Converts to this type from the input type.

impl FromBinaryValue for Date

fn from_stream_row(row: &StreamRow, idx: usize) -> Option<Date>

Extracts a value from a StreamRow at the given column index.

fn from_batch_row(row: &BatchRow, idx: usize) -> Option<Date>

Extracts a value from a BatchRow at the given column index.

impl FromHyperBinary for Date

fn from_hyper_binary(buf: &[u8]) -> Result<Date, Box<dyn Error + Sync + Send>>

Deserializes a value from HyperBinary format.

impl Hash for Date

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

where __H: Hasher,

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 IntoValue for &Date

fn add_to_inserter(&self, inserter: &mut Inserter<'_>) -> Result<()>

Adds this value to the inserter.

impl IntoValue for Date

fn add_to_inserter(&self, inserter: &mut Inserter<'_>) -> Result<()>

Adds this value to the inserter.

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

fn from_row(row: &Row, idx: usize) -> Option<Self>

Extract a value from a Row at the given column index.

impl ToHyperBinary for Date

fn to_hyper_binary( &self, buf: &mut BytesMut, ) -> Result<(), Box<dyn Error + Sync + Send>>

Serializes the value to HyperBinary format for a nullable column.

fn to_hyper_binary_not_null( &self, buf: &mut BytesMut, ) -> Result<(), Box<dyn Error + Sync + Send>>

Serializes the value to HyperBinary format for a NOT NULL column.

fn hyper_binary_size(&self) -> usize

Returns the size in bytes this value will occupy when serialized (nullable).

fn hyper_binary_size_not_null(&self) -> usize

Returns the size in bytes this value will occupy when serialized (not nullable).

impl ToSqlParam for Date

fn encode_param(&self) -> Option<Vec<u8>>

Encodes this value as binary bytes for use in parameterized queries.

fn sql_oid(&self) -> Oid

Returns the SQL type OID this parameter should bind as.

fn to_sql_literal(&self) -> String

Returns the SQL literal representation of this value.

impl Copy for Date

impl Eq for Date

impl StructuralPartialEq for Date