@spec parse(String.t(), Keyword.t()) :: {:ok, Time.t()} | {:error, Exception.t()}

Parses a locale-formatted time string.

Tries, in order: bare ISO-8601 (HH:MM[:SS[.frac]]), then the locale's CLDR short/medium/long/full time patterns. Locale patterns encode the locale's hour cycle (12-hour for en, ar; 24-hour for de, fr, ja) so the same input may parse to different times under different locales — by design.

Implements the parts of TR35 §Parsing Dates Times and §Parsing Day Periods that apply to time-only input.

Arguments

• input is the raw user input string.

• options is a keyword list of options.

Options

• :locale — the locale to interpret the string under. Defaults to Localize.get_locale/0.

Returns

• {:ok, Time.t()} on success.

• {:error, Calendrical.TimeParseError.t()} when no pattern matched.

Examples

iex> Calendrical.Time.parse("14:30:00", locale: :en)
{:ok, ~T[14:30:00]}

iex> Calendrical.Time.parse("2:30 PM", locale: :en)
{:ok, ~T[14:30:00]}

iex> Calendrical.Time.parse("14:30", locale: :de)
{:ok, ~T[14:30:00]}