Module datetime

Date and time utilities.

Modules

proto_date_time_units

Nested message and enum types in ProtoDateTimeUnits.

Structs

AnnotatedIntervalPart 🔒

AnnotatedIntervalPart contains the tokens to be parsed, as well as the format to parse them.

DateTimeFieldIterator

An iterator over DateTimeFields

DateTimeFieldValue

Tracks a unit and a fraction from a parsed time-like string, e.g. INTERVAL ‘1.2’ DAYS.

PackedNaiveTime

An encoded packed variant of NaiveTime.

ParsedDateTime

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

ProtoDateTimeUnits

Enums

CalendarEra

DateTimeField

DateTimePart

Order of definition is important for PartialOrd and Ord to be derived correctly

DateTimeUnits

Units of measurements associated with dates and times.

TimePartFormat 🔒

Interval strings can be presented in one of two formats:

TimeStrToken 🔒

TimeStrToken represents valid tokens in time-like strings, i.e those used in INTERVAL, TIMESTAMP/TZ, DATE, and TIME.

Functions

determine_format_w_datetimefield 🔒

Determines the format of the interval part (uses None to identify an indeterminant/ambiguous format). This is necessary because the interval string format is not LL(1); we instead parse as few tokens as possible to generate the string’s semantics.

expected_dur_like_tokens 🔒

Get the expected TimeStrTokens to parse SQL Standard time-like DateTimeFields, i.e. HOUR, MINUTE, SECOND. This is used for INTERVAL, TIMESTAMP, and TIME.

expected_sql_standard_interval_tokens 🔒

Get the expected TimeStrTokens to parse TimePartFormat::SqlStandard parts, starting from some DateTimeField. Delim tokens are never actually included in the output, but are illustrative of what the expected input of SQL Standard interval values looks like.

fill_pdt_date 🔒

Fills the year, month, and day fields of pdt using the TimeStrTokens in actual.

fill_pdt_from_tokens 🔒

Fills a ParsedDateTime’s fields using the actual tokens, starting at leading_field and descending to less significant DateTimeFields.

fill_pdt_interval_pg 🔒

Fills a ParsedDateTime’s fields for a single PostgreSQL-style interval parts, e.g. 1 month. Invoke this function once for each PostgreSQL-style interval part.

fill_pdt_interval_sql 🔒

Fills a ParsedDateTime’s fields when encountering SQL standard-style interval parts, e.g. 1-2 for Y-M 4:5:6.7 for H:M:S.NS.

fill_pdt_time 🔒

Fills the hour, minute, and second fields of pdt using the TimeStrTokens in actual.

ltrim_delim_or_colon 🔒

PostgreSQL treats out-of-place colons as errant punctuation marks, and trims them.

split_timestamp_string 🔒

Takes a ‘date timezone’ ‘date time timezone’ string and splits it into ‘date {time}’ and ‘timezone’ components then checks for a ‘CalenderEra’ defaulting to ‘AD’.

strip_era_from_timezone 🔒

tokenize_time_str 🔒

Convert a string from a time-like datatype (INTERVAL, TIMESTAMP/TZ, DATE, and TIME) into Vec<TimeStrToken>.

trim_and_return_sign 🔒