Changelog View Source

Cldr_Dates_Times v2.10.2

This is the changelog for Cldr_Dates_Times v2.10.2 released on January 15th, 2022. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix Date.to_string/2 when the second argument is a list of options and not a backend module. Previously this would ignore any :backend option and try to use Cldr.default_backend!/0 which would fail if not one was configured. The same fix is applied to Cldr.Time.to_string/2 and Cldr.DateTime.to_string/2.

Cldr_Dates_Times v2.10.1

This is the changelog for Cldr_Dates_Times v2.10.1 released on December 1st, 2021. For older changelogs please consult the release tag on GitHub

Bug Fixes

Replace use Mix.Config with import Config in config files
Correctly call transliterate_digits/3 not transliterate/3 when transliterating digits for date/time formats

Cldr_Dates_Times v2.10.0

This is the changelog for Cldr_Dates_Times v2.10.0 released on October 27th, 2021. For older changelogs please consult the release tag on GitHub

Enhancements

Improved localization in support of Chinese, Japanese and Korea calendars (era, month names, cyclic year, related gregorian year)
Updates to support CLDR release 40 via ex_cldr version 2.24

Bug Fixes

Fix year formatting to account for different calendar resolvers

Deprecations

Don't call deprecated Cldr.Config.get_locale/2, use Cldr.Locale.Loader.get_config/2 instead.
Don't call deprecated Cldr.Config.known_locale_names/1, call Cldr.Locale.Loader.known_locale_names/1 instead.

Cldr_Dates_Times v2.10.0-rc.3

This is the changelog for Cldr_Dates_Times v2.10.0-rc.3 released on October 25th, 2021. For older changelogs please consult the release tag on GitHub

Deprecations

Don't call deprecated Cldr.Config.known_locale_names/1, call Cldr.Locale.Loader.known_locale_names/1 instead.

Cldr_Dates_Times v2.10.0-rc.2

This is the changelog for Cldr_Dates_Times v2.10.0-rc.2 released on October 25th, 2021. For older changelogs please consult the release tag on GitHub

Deprecations

Don't call deprecated Cldr.Config.get_locale/2, use Cldr.Locale.Loader.get_config/2 instead.

Cldr_Dates_Times v2.10.0-rc.1

This is the changelog for Cldr_Dates_Times v2.10.0-rc.1 released on October 21st, 2021. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix year formatting to account for different calendar resolvers

Cldr_Dates_Times v2.10.0-rc.0

This is the changelog for Cldr_Dates_Times v2.10.0-rc.0 released on October 20th, 2021. For older changelogs please consult the release tag on GitHub

Enhancements

Improved localization in support of Chinese, Japanese and Korea calendars (era, month names, cyclic year, related gregorian year)
Update to ex_cldr version 2.24 which uses CLDR 40 data

Cldr_Dates_Times v2.9.4

This is the changelog for Cldr_Dates_Times v2.9.4 released on September 22nd, 2021. For older changelogs please consult the release tag on GitHub

Bug fixes

Fixes relative date and date time formatting when a :relative_to parameter and no :unit parameter is specified. Thanks to @maennchen for the report. Closes #26.

Cldr_Dates_Times v2.9.3

This is the changelog for Cldr_Dates_Times v2.9.3 released on September 20th, 2021. For older changelogs please consult the release tag on GitHub

Bug fixes

Fixes relative date and date time formatting when a :relative_to parameter and a :unit parameter is specified. Thanks to @DaTrader for the report. Closes #25.

Cldr_Dates_Times v2.9.2

This is the changelog for Cldr_Dates_Times v2.9.2 released on August 14th, 2021. For older changelogs please consult the release tag on GitHub

Bug fixes

Open interval formats can now also be called directly on the backend. For example:

  iex> MyApp.Cldr.Date.Interval.to_string ~D[2020-01-01], nil
  {:ok, "Jan 1, 2020 –"}

Cldr_Dates_Times v2.9.1

This is the changelog for Cldr_Dates_Times v2.9.1 released on August 14th, 2021. For older changelogs please consult the release tag on GitHub

Bug fixes

When formatting an open interval (one side is nil) the backend function date_time_interval_fallback/2 is used to retrieve the format pattern. Previously this function was being called with default parameters. Now it is properly called with a locale and a calendar.

Cldr_Dates_Times v2.9.0

This is the changelog for Cldr_Dates_Times v2.9.0 released on August 14th, 2021. For older changelogs please consult the release tag on GitHub

Bug fixes

Fix splitting interval formats when there is no repeating field. Use the principal that standalone formats are equivalent to normal formats when splitting. ie, for this purposes "L" == "M". This means the locale "fa" no longer raises an exception.

Enhancements

Allow formatting of intervals where one side is nil. This will produce an open-ended interval. Only one side of the interval can be nil. Thanks to @woylie for the request. Closes #23.

Examples

  iex> Cldr.Date.Interval.to_string ~D[2020-01-01], nil, MyApp.Cldr,
  ...> format: :short
  {:ok, "1/1/20 –"}

  iex> Cldr.Time.Interval.to_string ~U[2020-01-01 00:00:00.0Z], nil, MyApp.Cldr,
  ...> format: :long, style: :flex
  {:ok, "12:00:00 AM UTC –"}

  iex> Cldr.DateTime.Interval.to_string ~U[2020-01-01 00:00:00.0Z], nil, MyApp.Cldr
  {:ok, "Jan 1, 2020, 12:00:00 AM –"}

Cldr_Dates_Times v2.8.0

This is the changelog for Cldr_Dates_Times v2.8.0 released on July 1st, 2021. For older changelogs please consult the release tag on GitHub

Bug fixes

Fixes formatting time intervals that by checking for a format key of :h in addition to the :a and :b format keys (simialr to issue #22).

Enhancments

Updated to ex_cldr version 2.23.0 which changes the names of some of the field in the "-u-" extension to match the CLDR canonical name. In particular the field name hour_cycle changes to hc. The values for hc also change to the canonical forms of :h12, :h11, :h23 and :h24.

Cldr_Dates_Times v2.7.2

This is the changelog for Cldr_Dates_Times v2.7.2 released on May 6th, 2021. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix regression time intervals where the start time is "a.m." and the end time is "p.m." and the format code is :b (previously assumed :a). Thanks to @bryanlep for the report. Closes #22.

Cldr_Dates_Times v2.7.1

This is the changelog for Cldr_Dates_Times v2.7.1 released on May 6th, 2021. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix formatting time intervals where the start time is "a.m." and the end time is "p.m.". Thanks to @sfusato for the report. Closes #21.

Cldr_Dates_Times v2.7.0

This is the changelog for Cldr_Dates_Times v2.7.0 released on April 8th, 2021. For older changelogs please consult the release tag on GitHub

Data changes

Some date and time formats have changed for some locales. This applies to interval date, time and datetime formats in en locale for example. Some time formats have also now changed in en from 24-hour times to am/pm formats.

Enhancements

Add support for CLDR 39

Cldr_Dates_Times v2.7.0-rc.0

This is the changelog for Cldr_Dates_Times v2.7.0-rc.0 released on March 19th, 2021. For older changelogs please consult the release tag on GitHub

Data changes

Some date and time formats have changed for some locales. This applies to interval date, time and datetime formats in en locale for example. Some time formats have also now changed in en from 24-hour times to am/pm formats.

Enhancements

Add support for CLDR 39

Cldr_Dates_Times v2.6.4

This is the changelog for Cldr_Dates_Times v2.6.4 released on December 17th, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Remove xref section from the project in mix.exs. The fixes an error where the configuration for xref was incorrect and causing compiler errors on some versions of Elixir. Closes #19. Thanks to @fertapric.
Make dependencies eprof and dialyixir optional so that they aren't dragged into host apps unnecessarily.

Cldr_Dates_Times v2.6.3

This is the changelog for Cldr_Dates_Times v2.6.3 released on December 3rd, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

[UPDATED] Fix regression whereby formatting a Date or Time via a backend with no options would raise a Cldr.NoDefaultBackendError (No default :ex_cldr backend is configured) exception. Closes #18 properly. Thanks to @maennchen.

Cldr_Dates_Times v2.6.2

This is the changelog for Cldr_Dates_Times v2.6.2 released on December 2nd, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix regression whereby formatting a DateTime via a backend with no options would raise a Cldr.NoDefaultBackendError (No default :ex_cldr backend is configured) exception. Closes #18. Thanks to @maennchen.

Cldr_Dates_Times v2.6.1

This is the changelog for Cldr_Dates_Times v2.6.1 released on November 30th, 2020. For older changelogs please consult the release tag on GitHub

Performance improvements

Don't transliterate when the number system is :latn (which it most commonly is). The improves formatting performance by about 40%.
Handle default parameters more efficiently which improves performance by a further 10%.

Cldr_Dates_Times v2.6.0

This is the changelog for Cldr_Dates_Times v2.6.0 released on November 1st, 2020. For older changelogs please consult the release tag on GitHub

Enhancements

Add support for CLDR 38

Cldr_Dates_Times v2.5.4

This is the changelog for Cldr_Dates_Times v2.5.4 released on September 26th, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Use Cldr.Date.default_backend/0 as a shim to provide compatibility for the upcoming ex_cldr version 2.18.0 where Cldr.default_backend/0 is deprecated in favour of Cldr.default_backend!/0

Cldr_Dates_Times v2.5.3

This is the changelog for Cldr_Dates_Times v2.5.3 released on September 22nd, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix compiler warns on duplicate @doc on Elixir 1.11

Cldr_Dates_Times v2.5.2

This is the changelog for Cldr_Dates_Times v2.5.2 released on September 2nd, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Correct the spec for Cldr.DateTime.Relative.to_string!/3. Thanks to @loskobrakai.

Cldr_Dates_Times v2.5.1

This is the changelog for Cldr_Dates_Times v2.5.1 released on June 17th, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Use locale's number system if no optional number system is provided. Fixes Cldr.Date, Cldr.Time and Cldr.DateTime
Fix datetime formatting for CalendarIntervals that have minute precision. In these cases, :seconds and :microseconds should be zeroed.
Fix links to hex.pm for calendar_interval

Cldr_Dates_Times v2.5.0

This is the changelog for Cldr_Dates_Times v2.5.0 released on June 13th, 2020. For older changelogs please consult the release tag on GitHub

Enhancements

Add localized interval formatting with Cldr.Interval.to_string/3 and specific implementations in Cldr.Date.Interval.to_string/3, Cldr.Time.Interval.to_string/3 and Cldr.DateTime.to_string/3
Add <backend>.Interval.to_string/3, <backend>.Date.Interval.to_string/3, <backend>.Time.Interval.to_string/3, <backend>.DateTime.Interval.to_string/3
Add :precompiled_interval_formats defined in the backend configuration

Bug Fixes

Correct doc examples in README.md. Thanks to @tcitworld. Closes #13.
Fix options processing for :style and :format for Cldr.Date.to_string/3, Cldr.DateTime.to_string/3 and Cldr.Time.to_string/3. :format is preferred although :style is honoured.
Fix transliteration to other number systems
Retrieve :precompiled_date_time_formats from the backend configuration, not the global configuration

Cldr_Dates_Times v2.4.0

This is the changelog for Cldr_Dates_Times v2.4.0 released on May 4th, 2020. For older changelogs please consult the release tag on GitHub

Enhancements

Add Cldr.Time.hour_format_from_locale/1 to return the hour formatted preferred for a locale
Add Cldr.DateTime.Formatter.hour/{2, 4} that formats the hour part of a time in accordance with locale preferences (including honouring the hc key of the u language tag extension)
Add format symbol ddd to return the day of the month with ordinal formatting. This not a CLDR standard format symbol.
Add protocol support for Cldr.Chars which is used by Cldr.to_string/1

Cldr_Dates_Times v2.3.0

This is the changelog for Cldr_Dates_Times v2.3.0 released on February 2nd, 2020. For older changelogs please consult the release tag on GitHub

Enhancements

Adds backend modules MyApp.Cldr.Date, MyApp.Cldr.Time and MyApp.Cldr.DateTime that contain the functions to_string/2 and to_string!/2. This means all the ex_cldr family of libraries should now be primarily called on the backend modules. This makes aliasing easier too. For example:

defmodule MyApp.Cldr do
  use Cldr, providers: [Cldr.Number, Cldr.DateTime], default_locale: "en"
end

defmodule MyApp do
  alias MyApp.Cldr

  def some_fun do
    Cldr.Date.to_string Date.utc_today()
  end
end

Cldr_Dates_Times v2.2.4

This is the changelog for Cldr_Dates_Times v2.2.4 released on January 14th, 2020. For older changelogs please consult the release tag on GitHub

Bug Fixes

Update tests for Elixir 1.10 date/time inspection changes
Fix dialyzer warning in generated backend

Cldr_Dates_Times v2.2.3

This is the changelog for Cldr_Dates_Times v2.2.3 released on September 14th, 2019. For older changelogs please consult the release tag on GitHub

Bug Fixes

Correctly uses a provided :backend option when validating the :locale option to the various to_string/3 calls. Thanks to @lostkobrakai. Closes #108 and #109.

Cldr_Dates_Times v2.2.2

This is the changelog for Cldr_Dates_Times v2.2.2 released on August 31st, 2019. For older changelogs please consult the release tag on GitHub

Changes & Deprecations

Deprecates the option :format on Cldr.DateTime.Relative.to_string/3 in favour of :style. :format will be removed with ex_cldr_dates_times version 3.0

Bug Fixes

Return an error tuple immediately when a format code is used but no data is available to fulfill it

Cldr_Dates_Times v2.2.1

This is the changelog for Cldr_Dates_Times v2.2.1 released on August 23rd, 2019. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fix @spec for Cldr.Date.to_string/3, Cldr.Time.to_string/3 and Cldr.DateTime.to_string/3 as well as the ! variants.

Cldr_Dates_Times v2.2.0

This is the changelog for Cldr_Dates_Times v2.2.0 released on August 23rd, 2019. For older changelogs please consult the release tag on GitHub

Breaking change

Support Elixir 1.8 and later only since this package depends on ex_cldr_calendars which requires Elixir 1.8.

Bug Fixes

Fix references to Cldr.get_current_locale/0 to the current Cldr.get_locale/0
Fix dialyzer warnings

Cldr_Dates_Times v2.1.0

This is the changelog for Cldr_Dates_Times v2.1.0 released on June 16th, 2019. For older changelogs please consult the release tag on GitHub

Enhancements

All calling Date, Time and DateTime to_string/3 as to_string/1 omitting the backend and providing options. The backend will default to Cldr.default_backend(). An exception will be raised if there is no default backend.
Updates to ex_cldr_calendars 1.0 which includes Cldr.Calendar.week_of_month/1. The result corresponds to the W format which is now implemented as well.

Cldr_Dates_Times v2.0.2

This is the changelog for Cldr_Dates_Times v2.0.2 released on June 12th, 2019. For older changelogs please consult the release tag on GitHub

Bug Fixes

Resolve the actual number system before transliterating a date, time or datetime. Closes #9. Thanks to @ribanez7 for the report.

Cldr_Dates_Times v2.0.1

This is the changelog for Cldr_Dates_Times v2.0.1 released on June 9th, 2019. For older changelogs please consult the release tag on GitHub

Bug Fixes

Fixes a formatter code generation error when a format is a tuple form not a string form.

Cldr_Dates_Times v2.0.0

This is the changelog for Cldr_Dates_Times v2.0 released on June 9th, 2019. For older changelogs please consult the release tag on GitHub

This release depends on ex_cldr_calendars which provides the underlying calendar calculations as well as providing a set of additional calendars.

Breaking Changes

ex_cldr_dates_times requires a minimum Elixir version of 1.8. It depends on Calendar capabilities built into this and later release.
ex_cldr_dates_times now depends upon ex_cldr version 2.0. As a result it is a requirement that at least one backend module be configured as described in the ex_cldr readme.
The public API is now based upon functions defined on a backend module. Therefore calls to functions such as Cldr.DateTime.to_string/3 should be replaced with calls to MyApp.Cldr.DateTime.to_string/3 (assuming your configured backend module is called MyApp.Cldr).

Enhancements

Correctly calculates week_of_year
Supports Calendar.ISO and any calendar defined with Cldr.Calendar (see ex_cldr_calendars)

Known limitations

Does not calculate week_of_month. If called will return 1 for all input values.

Migration

ex_cldr_dates_times uses the configuration set for the dependency ex_cldr. See the documentation for ex_cldr

Unlike ex_cldr_dates_times version 1, version 2 requires one or more backend modules to host the functions that manage CLDR data. An example to get started is:

Create a backend module:

defmodule MyApp.Cldr do
  use Cldr,
    locales: ["en", "fr", "ja"],
    providers: [Cldr.Number, Cldr.Calendar, Cldr.DateTime]

end

Update config.exs configuration to specify this backend as the system default:

config :ex_cldr,
  default_locale: "en",
  default_backend: MyApp.Cldr

Replace calls to Date. Time and DateTime functions to_string/2 with calls to to_string/3 where the second parameter is a backend module.

← Previous Page Date and Time Localization and Formatting

Next Page → LICENSE