Enum DatePart 

#[non_exhaustive]
pub enum DatePart {
    Quarter,
    Year,
    YearISO,
    Month,
    Week,
    WeekISO,
    Day,
    DayOfWeekSunday0,
    DayOfWeekMonday0,
    DayOfYear,
    Hour,
    Minute,
    Second,
    Millisecond,
    Microsecond,
    Nanosecond,
}

Valid parts to extract from date/time/timestamp arrays.

See date_part.

Marked as non-exhaustive as may expand to support more types of date parts in the future.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Quarter

Quarter of the year, in range 1..=4

Year

Calendar year

YearISO

ISO year, computed as per ISO 8601

Month

Month in the year, in range 1..=12

Week

week of the year, in range 1..=53, computed as per ISO 8601

WeekISO

ISO week of the year, in range 1..=53

Day

Day of the month, in range 1..=31

DayOfWeekSunday0

Day of the week, in range 0..=6, where Sunday is 0

DayOfWeekMonday0

Day of the week, in range 0..=6, where Monday is 0

DayOfYear

Day of year, in range 1..=366

Hour

Hour of the day, in range 0..=23

Minute

Minute of the hour, in range 0..=59

Second

Second of the minute, in range 0..=59

Millisecond

Millisecond of the second

Microsecond

Microsecond of the second

Nanosecond

Nanosecond of the second

Trait Implementations

impl Clone for DatePart

fn clone(&self) -> DatePart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatePart

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

Formats the value using the given formatter.

impl Display for DatePart

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

Formats the value using the given formatter.

impl FromStr for DatePart

Parses a string into a DatePart.

Matching is case-insensitive. The accepted names follow PostgreSQL’s EXTRACT / date_part conventions (see https://www.postgresql.org/docs/current/functions-datetime.html#FUNCTIONS-DATETIME-EXTRACT) and are aligned with the alias set accepted by arrow-cast’s IntervalUnit::from_str (plurals, short forms like y, mon, ms, us) so the two parsers round-trip on the names they share.

Names that do not map one-to-one onto a DatePart variant are intentionally not recognized:

• epoch — a derived computation, not a date part.
• century, decade, millennium — no matching DatePart variant.
• timezone, timezone_hour, timezone_minute — not modeled by DatePart.
• isodow — PostgreSQL’s isodow returns 1..=7 (Mon=1), but the closest variant (DatePart::DayOfWeekMonday0) returns 0..=6. Accepting it here would silently shift the value range; callers that need the PostgreSQL semantic should map the alias themselves and add 1 to the extracted value.

type Err = ArrowError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<DatePart, ArrowError>

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

impl PartialEq for DatePart

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

impl Eq for DatePart

impl StructuralPartialEq for DatePart