Cldr.DateTime.Interval (Cldr Dates & Times v2.7.0) View Source
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.
See Cldr.Interval.to_string/3
and Cldr.DateTime.Interval.to_string/3
Link to this section Summary
Functions
Returns a localised string representing the formatted interval formed by two dates.
Returns a localised string representing the formatted interval formed by two dates or raises an exception.
Returns a localised string representing the formatted interval formed by two dates or raises an exception.
Link to this section Functions
Specs
to_string(Calendar.datetime(), Calendar.datetime(), Cldr.backend(), Keyword.t()) :: {:ok, String.t()} | {:error, {module(), String.t()}}
Returns a localised string representing the formatted interval formed by two dates.
Arguments
from
is any map that conforms to theCalendar.datetime
type.to
is any map that conforms to theCalendar.datetime
type.to
must occur on or afterfrom
.backend
is any module that includesuse Cldr
and is therefore aCldr
backend moduleoptions
is a keyword list of options. The default is[]
.
Options
:format
is one of:short
,:medium
or:long
or a specific format type or a string representing of an interval format. The default is:medium
.locale
is any valid locale name returned byCldr.known_locale_names/0
or aCldr.LanguageTag
struct. The default isCldr.get_locale/0
number_system:
a number system into which the formatted date digits should be transliterated
Returns
{:ok, string}
or{:error, {exception, reason}}
Notes
For more information on interval format string see the
Cldr.Interval
.The available predefined formats that can be applied are the keys of the map returned by
Cldr.DateTime.Format.interval_formats("en", :gregorian)
where"en"
can be replaced by any configuration locale name and:gregorian
is the underlyingCLDR
calendar type.In the case where
from
andto
are equal, a single date is formatted instead of an interval
Examples
iex> Cldr.DateTime.Interval.to_string ~U[2020-01-01 00:00:00.0Z],
...> ~U[2020-12-31 10:00:00.0Z], MyApp.Cldr
{:ok, "Jan 1, 2020, 12:00:00 AM – Dec 31, 2020, 10:00:00 AM"}
Specs
to_string!(CalendarInterval.t(), Cldr.backend(), Keyword.t()) :: String.t() | no_return()
Returns a localised string representing the formatted interval formed by two dates or raises an exception.
Arguments
from
is any map that conforms to theCalendar.datetime
type.to
is any map that conforms to theCalendar.datetime
type.to
must occur on or afterfrom
.backend
is any module that includesuse Cldr
and is therefore aCldr
backend module.options
is a keyword list of options. The default is[]
.
Options
:format
is one of:short
,:medium
or:long
or a specific format type or a string representing of an interval format. The default is:medium
.locale
is any valid locale name returned byCldr.known_locale_names/0
or aCldr.LanguageTag
struct. The default isCldr.get_locale/0
.number_system:
a number system into which the formatted date digits should be transliterated.
Returns
string
orraises an exception
Notes
For more information on interval format string see the
Cldr.Interval
.The available predefined formats that can be applied are the keys of the map returned by
Cldr.DateTime.Format.interval_formats("en", :gregorian)
where"en"
can be replaced by any configuration locale name and:gregorian
is the underlyingCLDR
calendar type.In the case where
from
andto
are equal, a single date is formatted instead of an interval
Examples
iex> use CalendarInterval
iex> Cldr.DateTime.Interval.to_string! ~I"2020-01-01 00:00/10:00", MyApp.Cldr
"Jan 1, 2020, 12:00:00 AM – 10:00:59 AM"
Returns a localised string representing the formatted interval formed by two dates or raises an exception.
Arguments
from
is any map that conforms to theCalendar.datetime
type.to
is any map that conforms to theCalendar.datetime
type.to
must occur on or afterfrom
.backend
is any module that includesuse Cldr
and is therefore aCldr
backend module.options
is a keyword list of options. The default is[]
.
Options
:format
is one of:short
,:medium
or:long
or a specific format type or a string representing of an interval format. The default is:medium
.locale
is any valid locale name returned byCldr.known_locale_names/0
or aCldr.LanguageTag
struct. The default isCldr.get_locale/0
.number_system:
a number system into which the formatted date digits should be transliterated.
Returns
string
orraises an exception
Notes
For more information on interval format string see the
Cldr.Interval
.The available predefined formats that can be applied are the keys of the map returned by
Cldr.DateTime.Format.interval_formats("en", :gregorian)
where"en"
can be replaced by any configuration locale name and:gregorian
is the underlyingCLDR
calendar type.In the case where
from
andto
are equal, a single date is formatted instead of an interval
Examples
iex> Cldr.DateTime.Interval.to_string! ~U[2020-01-01 00:00:00.0Z],
...> ~U[2020-12-31 10:00:00.0Z], MyApp.Cldr
"Jan 1, 2020, 12:00:00 AM – Dec 31, 2020, 10:00:00 AM"