# Cldr Dates & Times v2.25.6 - API Reference

## Modules

- [Cldr.Date](Cldr.Date.md): Provides localized and formatting of a `t:Date.t/0`
struct or any map with one or more of the keys `:year`, `:month`,
`:day` and optionally `:calendar`.
- [Cldr.DateTime](Cldr.DateTime.md): Provides localized formatting of full or partial date_times.
- [Cldr.DateTime.Relative](Cldr.DateTime.Relative.md): Functions to support the string formatting of relative date/time/datetime numbers.
- [Cldr.Time](Cldr.Time.md): Provides localization and formatting of a time.

- Interval
  - [Cldr.Date.Interval](Cldr.Date.Interval.md): Interval formats allow for software to format intervals like "Jan 10-12, 2008" as a
shorter and more natural format than "Jan 10, 2008 - Jan 12, 2008". They are designed
to take a start and end date, time or datetime plus a formatting pattern
and use that information to produce a localized format.
  - [Cldr.DateTime.Interval](Cldr.DateTime.Interval.md): Interval formats allow for software to format intervals like "Jan 10-12, 2008" as a
shorter and more natural format than "Jan 10, 2008 - Jan 12, 2008". They are designed
to take a start and end *date*, *time* or *date_time* plus a formatting pattern
and use that information to produce a localized formatted string.
  - [Cldr.Interval](Cldr.Interval.md): Interval formats allow for software to format intervals like "Jan 10-12, 2008" as a
shorter and more natural format than "Jan 10, 2008 - Jan 12, 2008". They are designed
to take a start and end date, time or datetime plus a formatting pattern
and use that information to produce a localized format.
  - [Cldr.Time.Interval](Cldr.Time.Interval.md): Interval formats allow for software to format intervals like "Jan 10-12, 2008" as a
shorter and more natural format than "Jan 10, 2008 - Jan 12, 2008". They are designed
to take a start and end date, time or datetime plus a formatting pattern
and use that information to produce a localized format.

- Formats
  - [Cldr.DateTime.Format](Cldr.DateTime.Format.md): Manages the Date, Time and DateTime formats defined by CLDR.
  - [Cldr.DateTime.Format.Compiler](Cldr.DateTime.Format.Compiler.md): Tokenizes and parses `Date`, `Time` and `DateTime` format strings.
  - [Cldr.DateTime.Format.Match](Cldr.DateTime.Format.Match.md): Implements best match for a requested skeleton to an available format ID.
  - [Cldr.DateTime.Formatter](Cldr.DateTime.Formatter.md): Functions that implement the formatting for each specific
format symbol.

- Timezones
  - [Cldr.DateTime.Timezone](Cldr.DateTime.Timezone.md): Functions to format [IANA time zone IDs](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones),
including the time zone field of a `t:DateTime.t/0`.

- Exceptions
  - [Cldr.DateTime.Compiler.ParseError](Cldr.DateTime.Compiler.ParseError.md): Exception raised when tokenizing a datetime format.

  - [Cldr.DateTime.DateTimeOrderError](Cldr.DateTime.DateTimeOrderError.md): Exception raised when the first
datetime in an interval is greater than
the last datetime.

  - [Cldr.DateTime.FormatError](Cldr.DateTime.FormatError.md): Exception raised when attempting to
format a date or time which does not have
the data available to fulfill the format.

  - [Cldr.DateTime.IncompatibleTimeZonerError](Cldr.DateTime.IncompatibleTimeZonerError.md): Exception raised when the two
datetimes are in different time zones

  - [Cldr.DateTime.IntervalFormatError](Cldr.DateTime.IntervalFormatError.md): Exception raised when attempting to
compile an interval format.

  - [Cldr.DateTime.InvalidFormat](Cldr.DateTime.InvalidFormat.md): Exception raised when formatting and there is no
data for the given format.

  - [Cldr.DateTime.NoTerritoryForTimezone](Cldr.DateTime.NoTerritoryForTimezone.md): Exception raised when an attempt is made to get the territory for
a time zone and it has none - like "UTC"

  - [Cldr.DateTime.UnknownTimeUnit](Cldr.DateTime.UnknownTimeUnit.md): Exception raised when an attempt is made to use a time unit that is not known
in `Cldr.DateTime.Relative`.

  - [Cldr.DateTime.UnresolvedFormat](Cldr.DateTime.UnresolvedFormat.md): Exception raised when formatting and there is no
data for the given format.

  - [Cldr.UnknownTimezone](Cldr.UnknownTimezone.md): Exception raised when an attempt is made to use a time zone that is not known.