Struct ParsedDateTime

pub struct ParsedDateTime {
    pub millennium: Option<DateTimeFieldValue>,
    pub century: Option<DateTimeFieldValue>,
    pub decade: Option<DateTimeFieldValue>,
    pub year: Option<DateTimeFieldValue>,
    pub month: Option<DateTimeFieldValue>,
    pub day: Option<DateTimeFieldValue>,
    pub hour: Option<DateTimeFieldValue>,
    pub minute: Option<DateTimeFieldValue>,
    pub second: Option<DateTimeFieldValue>,
    pub millisecond: Option<DateTimeFieldValue>,
    pub microsecond: Option<DateTimeFieldValue>,
    pub timezone_offset_second: Option<Timezone>,
}

All of the fields that can appear in a literal DATE, TIME, TIMESTAMP or INTERVAL string.

Fields

millennium: Option<DateTimeFieldValue>

century: Option<DateTimeFieldValue>

decade: Option<DateTimeFieldValue>

year: Option<DateTimeFieldValue>

month: Option<DateTimeFieldValue>

day: Option<DateTimeFieldValue>

hour: Option<DateTimeFieldValue>

minute: Option<DateTimeFieldValue>

second: Option<DateTimeFieldValue>

millisecond: Option<DateTimeFieldValue>

microsecond: Option<DateTimeFieldValue>

timezone_offset_second: Option<Timezone>

Implementations

impl ParsedDateTime

pub fn compute_interval(&self) -> Result<Interval, String>

Compute an Interval from an ParsedDateTime.

Errors

• If any component overflows a parameter (i.e. i64).

fn add_field( &self, d: DateTimeField, months: &mut i32, days: &mut i32, micros: &mut i64, ) -> Result<(), String>

Adds the appropriate values from self’s ParsedDateTime to months, days, and micros. These fields are then appropriate to construct std::time::Duration, once accounting for their sign.

Errors

• If any component overflows a parameter (i.e. i64).

pub fn compute_date(&self) -> Result<NaiveDate, String>

Compute a chrono::NaiveDate from an ParsedDateTime.

Errors

• If year, month, or day overflows their respective parameter in chrono::naive::date::NaiveDate::from_ymd_opt.

Note: Postgres does not recognize Year 0, but in order to make arithmetic work as expected, the Year 1 BC in a ParsedDateTime is mapped to the Year 0 in a NaiveDate, and vice-versa.

pub fn compute_time(&self) -> Result<NaiveTime, String>

Compute a chrono::NaiveDate from an ParsedDateTime.

Errors

• If hour, minute, or second (both unit and fraction) overflow u32.

pub fn build_parsed_datetime_interval( value: &str, leading_time_precision: Option<DateTimeField>, ambiguous_resolver: DateTimeField, ) -> Result<ParsedDateTime, String>

Builds a ParsedDateTime from an interval string (value).

Arguments

• value is a PostgreSQL-compatible interval string, e.g INTERVAL 'value'.
• leading_time_precision optionally identifies the leading time component HOUR | MINUTE to disambiguate {}:{} formatted intervals
• ambiguous_resolver identifies the DateTimeField of the final part if it’s ambiguous, e.g. in INTERVAL '1' MONTH ‘1’ is ambiguous as its DateTimeField, but MONTH resolves the ambiguity.

pub fn build_parsed_datetime_timestamp( value: &str, era: CalendarEra, ) -> Result<ParsedDateTime, String>

Builds a ParsedDateTime from a TIMESTAMP string (value).

Arguments

• value is a SQL-formatted TIMESTAMP string.

pub fn build_parsed_datetime_time(value: &str) -> Result<ParsedDateTime, String>

Builds a ParsedDateTime from a TIME string (value).

Arguments

• value is a SQL-formatted TIME string.

pub fn write_field_iff_none( &mut self, f: DateTimeField, u: Option<DateTimeFieldValue>, ) -> Result<(), String>

Write to the specified field of a ParsedDateTime iff it is currently set to None; otherwise generate an error to propagate to the user.

fn seconds_has_fraction(&self) -> bool

pub fn check_datelike_bounds(&mut self) -> Result<(), String>

pub fn check_interval_bounds(&self, d: DateTimeField) -> Result<(), String>

pub fn clear_date(&mut self)

fn units_of(&self, field: DateTimeField) -> Option<DateTimeFieldValue>

Retrieve any value that we parsed out of the literal string for the field.

Trait Implementations

impl Clone for ParsedDateTime

fn clone(&self) -> ParsedDateTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedDateTime

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

Formats the value using the given formatter.

impl Default for ParsedDateTime

fn default() -> Self

Returns the “default value” for a type.

impl Hash for ParsedDateTime

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 ParsedDateTime

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

impl StructuralPartialEq for ParsedDateTime