Module repr::adt::datetime

Date and time utilities.

Modules

fixed_offset_serde

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.

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.

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