Cldr.Date.Interval.to_string-exclamation-mark

You're seeing just the function to_string-exclamation-mark, go back to Cldr.Date.Interval module for more information.

to_string!(range, backend, options)

Specs

to_string!(Cldr.Interval.range(), Cldr.backend(), Keyword.t()) ::
  String.t() | no_return()

Returns a Date.Range or CalendarInterval as a localised string or raises an exception.

Arguments

range is either a Date.Range.t returned from Date.range/2 or a CalendarInterval.t
backend is any module that includes use Cldr and is therefore a Cldr 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.
:style supports dfferent formatting styles. The alternatives are :date, :month_and_day, :month and :year_and_month. The default is :date.
locale is any valid locale name returned by Cldr.known_locale_names/0 or a Cldr.LanguageTag struct. The default is Cldr.get_locale/0
number_system: a number system into which the formatted date digits should be transliterated

Returns

string or
raises an exception

Notes

CalendarInterval support requires adding the dependency calendar_interval to the deps configuration in mix.exs.
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 underlying CLDR calendar type.
In the case where from and to are equal, a single date is formatted instead of an interval

Examples

iex> Cldr.Date.Interval.to_string! Date.range(~D[2020-01-01], ~D[2020-12-31]), MyApp.Cldr
"Jan 1 – Dec 31, 2020"

iex> Cldr.Date.Interval.to_string! Date.range(~D[2020-01-01], ~D[2020-01-12]), MyApp.Cldr
"Jan 1 – 12, 2020"

iex> Cldr.Date.Interval.to_string! Date.range(~D[2020-01-01], ~D[2020-01-12]), MyApp.Cldr,
...> format: :long
"Wed, Jan 1 – Sun, Jan 12, 2020"

iex> Cldr.Date.Interval.to_string! Date.range(~D[2020-01-01], ~D[2020-12-01]), MyApp.Cldr,
...> format: :long, style: :year_and_month
"January – December 2020"

iex> use CalendarInterval
iex> Cldr.Date.Interval.to_string! ~I"2020-01/12", MyApp.Cldr
"Jan 1 – Dec 31, 2020"

iex> Cldr.Date.Interval.to_string! Date.range(~D[2020-01-01], ~D[2020-01-12]), MyApp.Cldr,
...> format: :short
"1/1/2020 – 1/12/2020"

iex> Cldr.Date.Interval.to_string! Date.range(~D[2020-01-01], ~D[2020-01-12]), MyApp.Cldr,
...> format: :long, locale: "fr"
"mer. 1 – dim. 12 janv. 2020"

to_string!(from, to, backend, options \\ [])