Module mz_repr::adt::datetime

Date and time utilities.

Modules

fixed_offset_serde 🔒

proto_date_time_units

Nested message and enum types in ProtoDateTimeUnits.

proto_timezone

Nested message and enum types in ProtoTimezone.

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.

ParsedDateTime

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

ProtoDateTimeUnits

ProtoTimezone

Enums

DateTimeField

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.

Timezone

Parsed timezone.

Constants

_IMPL_ARBITRARY_FOR_DateTimeUnits 🔒

_IMPL_ARBITRARY_FOR_Timezone 🔒

Functions

build_timezone_offset_second 🔒

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

tokenize_time_str 🔒

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

tokenize_timezone 🔒

trim_and_return_sign 🔒