Cldr.DateTime.Interval.to_string-exclamation-mark
to_string-exclamation-mark, go back to Cldr.DateTime.Interval module for more information.
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
fromis any map that conforms to theCalendar.datetimetype.tois any map that conforms to theCalendar.datetimetype.tomust occur on or afterfrom.backendis any module that includesuse Cldrand is therefore aCldrbackend module.optionsis a keyword list of options. The default is[].
Options
:formatis one of:short,:mediumor:longor a specific format type or a string representing of an interval format. The default is:medium.localeis any valid locale name returned byCldr.known_locale_names/0or aCldr.LanguageTagstruct. The default isCldr.get_locale/0.number_system:a number system into which the formatted date digits should be transliterated.
Returns
stringorraises 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:gregorianis the underlyingCLDRcalendar type.In the case where
fromandtoare 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
fromis any map that conforms to theCalendar.datetimetype.tois any map that conforms to theCalendar.datetimetype.tomust occur on or afterfrom.backendis any module that includesuse Cldrand is therefore aCldrbackend module.optionsis a keyword list of options. The default is[].
Options
:formatis one of:short,:mediumor:longor a specific format type or a string representing of an interval format. The default is:medium.localeis any valid locale name returned byCldr.known_locale_names/0or aCldr.LanguageTagstruct. The default isCldr.get_locale/0.number_system:a number system into which the formatted date digits should be transliterated.
Returns
stringorraises 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:gregorianis the underlyingCLDRcalendar type.In the case where
fromandtoare 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"