Packages

ex_money

3.4.2
6.1.1 6.1.0 6.0.0 6.0.0-rc.0 5.24.2 5.24.1 5.24.0 retired 5.23.0 5.22.0 5.21.0 5.20.0 5.19.2 5.19.1 5.19.0 5.18.0 5.17.2 5.17.1 5.17.0 5.16.1 5.16.0 5.15.4 5.15.3 5.15.2 5.15.1 5.15.0 5.14.1 5.13.0 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 5.11.0 5.10.0 5.9.0 5.8.0 5.7.4 5.7.3 5.7.2 5.7.1 5.7.0 5.6.0 5.5.5 5.5.4 5.5.3 5.5.2 5.5.1 5.5.0 5.4.1 5.4.0 5.4.0-rc.0 5.3.2 5.3.1 5.3.0 5.2.1 5.2.0 5.1.0 5.0.2 5.0.1 5.0.0 retired 4.4.3 4.4.2 retired 4.4.1 4.4.0 4.3.0 4.2.2 4.2.1 4.2.0 4.1.0 4.0.0 3.4.4 3.4.3 3.4.2 3.4.1 3.4.0 3.3.1 3.3.0 3.2.4 3.2.3 3.2.2 3.2.1 3.2.0 3.1.0 3.0.0 2.12.2 2.12.1 retired 2.12.0 retired 2.11.0 2.10.0 2.9.1 2.9.0 2.8.0 2.7.3 2.7.2 2.7.1 2.7.0 2.6.1 2.6.0 2.5.0 2.4.0 2.3.0 2.2.2 2.2.1 2.2.0 2.1.0 2.1.0-rc.1 retired 2.1.0-rc.0 retired 2.0.4 2.0.3 2.0.2 2.0.1 2.0.0 1.1.3 1.1.2 1.1.1 retired 1.1.0 1.0.0 1.0.0-rc.0 retired 0.9.0 retired 0.8.5 retired 0.8.4 retired 0.8.3 retired 0.8.2 retired 0.8.1 retired 0.8.0 retired 0.7.0 retired 0.6.2 retired 0.6.1 retired 0.6.0 retired 0.5.3 retired 0.5.2 retired 0.5.1 retired 0.5.0 retired 0.4.3 retired 0.4.2 retired 0.4.1 retired 0.4.0 retired 0.3.0 retired 0.2.0 retired 0.1.7 retired 0.1.6 retired 0.1.5 retired 0.1.4 retired 0.1.3 retired 0.1.2 retired 0.1.1 retired 0.1.0 retired 0.0.16 retired 0.0.15 retired 0.0.14 retired 0.0.13 retired 0.0.12 retired 0.0.11 retired 0.0.10 retired 0.0.9 retired 0.0.7 retired 0.0.6 retired 0.0.5 retired 0.0.4 retired 0.0.3 retired 0.0.2 retired

Money functions for operations on and localization of a money data type with support for ISO 4217 currencies and ISO 24165 digial tokens (crypto currencies).

HexDocs

Current section

Files

Jump to
Readme
161 Versions
6 Dependencies
17 Dependants
Files
Activity
ex_money CHANGELOG.md
Raw

CHANGELOG.md 

# Changelog for Cldr v3.4.2



This is the changelog for Cldr v3.4.2 released on April 16th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/cldr/tags)



### Bug Fixes



* `Money.put_fraction/2` now correctly allows setting the fraction to 0.



### Enhancements



* `Money.round/2` allows setting `:currency_digits` to an integer number of digits in addition to the options `:iso`, `:cash` and `:accounting`.  The default remains `:iso`.



* Improves the documentation for `Money.to_string/2`.



# Changelog for Cldr v3.4.1



This is the changelog for Cldr v3.4.1 released on April 5th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/cldr/tags)



### Bug Fixes



* Fix `README.md` markdown formatting error.  Thanks to @fireproofsocks for the report and @lostkobrakai for the fix.  Closes #99.



# Changelog for Cldr v3.4.0



This is the changelog for Cldr v3.4.0 released on March 28th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/cldr/tags)



### Enhancements



* Updates to [CLDR version 35.0.0](http://cldr.unicode.org/index/downloads/cldr-35) released on March 27th 2019 through `ex_cldr` version 2.6.0.



# Changelog for Cldr v3.3.1



This is the changelog for Cldr v3.3.1 released on March 8th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/cldr/tags)



### Bug Fixes



* Fix or silence dialyzer warnings



# Changelog for Cldr v3.3.0



This is the changelog for Cldr v3.3.0 released on February 24th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/cldr/tags)



### Enhancements



* Adds `Money.put_fraction/2`. This will set the fractional part of a money to the specified integer amount.  Examples:

```

  iex> Money.put_fraction Money.new(:USD, "2.49"), 99

  #Money<:USD, 2.99>



  iex> Money.put_fraction Money.new(:USD, "2.49"), 999

  {:error,

   {Money.InvalidAmountError, "Rounding up to 999 is invalid for currency :USD"}}

```



### Bug Fixes



* Parsing money strings now uses a more complete set of character definitions for decimal and grouping separators based upon the `characters.json` file of the "en" locale.



# Changelog for Money v3.2.4



This is the changelog for Money v3.2.4 released on February 13th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



### Bug Fixes



* Updates to [ex_cldr_currencies version 2.1.2](https://hex.pm/packages/ex_cldr_currencies/2.1.2) which correctly removes duplicate currency strings when the same string referred to different currency codes. See the [changelog](https://github.com/kipcole9/cldr_currencies/blob/v2.1.2/CHANGELOG.md) for further detail.



### Enhancements



* Adds a `:fuzzy` option to `Money.parse/2` that uses `String.jaro_distance/2` to help determine if the provided currency text can be resolved as a currency code.  For example:

```

  iex> Money.parse("100 eurosports", fuzzy: 0.8)

  #Money<:EUR, 100>



  iex> Money.parse("100 eurosports", fuzzy: 0.9)

  {:error,

   {Money.Invalid, "Unable to create money from \\"eurosports\\" and \\"100\\""}}

```



# Changelog for Money v3.2.3



This is the changelog for Money v3.2.3 released on February 12th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



### Bug Fixes



* Correctly parse money strings with unicode currency symbols like "€". Closes #95.  Thanks to @crbelaus.



# Changelog for Money v3.2.2



This is the changelog for Money v3.2.2 released on February 10th, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



### Enhancements



* Improves parsing of money strings. Parsing now uses various strings that [CLDR](https://cldr.unicode.org) knows about.  Some examples:



```

  iex> Money.parse "$au 12 346", locale: "fr"

  #Money<:AUD, 12346>

  iex> Money.parse "12 346 dollar australien", locale: "fr"

  #Money<:AUD, 12346>

  iex> Money.parse "A$ 12346", locale: "en"

  #Money<:AUD, 12346>

  iex> Money.parse "australian dollar 12346.45", locale: "en"

  #Money<:AUD, 12346.45>

  iex> Money.parse "AU$ 12346,45", locale: "de"

  #Money<:AUD, 12346.45>



  # Can also return the strings available for a given currency

  # and locale

  iex> Cldr.Currency.strings_for_currency :AUD, "de"

  ["aud", "au$", "australischer dollar", "australische dollar"]



  # Round trip formatting also seems to be ok

  iex> {:ok, string} = Cldr.Number.to_string 1234, Money.Cldr, currency: :AUD

  {:ok, "A$1,234.00"}

  iex> Money.parse string

  #Money<:AUD, 1234.00>

```

# Changelog for Money v3.2.1



This is the changelog for Money v3.2.1 released on February 2nd, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



### Bug Fixes



* Added `Money.Ecto.Composite.Type.cast/1` and `Money.Ecto.Map.Type.cast/1` for a `String.t` parameter. When a `String.t` is provided, `cast/1` will call `Money.parse/2` to create the `Money.t`.



* `Money.new/3` now uses the current locale on the default backend if no locale or backend is specified. This means that `Money.Ecto.Composite.Type.cast/1` and `Money.Ecto.Map.Type.cast/1` will be parsed using the locale that has been set for the current process in the default backend. As a result, a simple `type=text` form field can be used to input a money type (currency code and amount in a single string) that can then be cast to a `Money.t`.



# Changelog for Money v3.2.0



This is the changelog for Money v3.2.0 released on February 1st, 2019.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



### Bug Fixes



* Correctly generate `migrations_path/1` function based upon whether `Ecto` is configured and which version



### Enhancements



* Adds `Money.parse/2` which will parse a string comprising a currency code and an amount. It will return a `Money.t` or an error.  This function may be helpful in supporting money input in HTML forms.



# Changelog for Money v3.1.0



This is the changelog for Money v3.1.0 released on December 30th, 2018.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



### Bug Fixes



* Fix typo in `exchange_rates_retriever.ex`.  Thanks to @lostkobrakai.  Closes #91.



* Remove obsolete `cldr` compiler



* Changes the `sum` aggregate function for `money_with_currency` to be `STRICT` which means it handles `NULL` columns in the same way as the standard `SUM` function.  Thanks to @lostkobrakai.  Closes #88.



* Fixes documentation link errors



* Fix unhandled terminate typo error in exchange rates server. Thanks to @xavier. Closes #90.



# Changelog for Money v3.0.0



This is the changelog for Money v3.0.0 released on November 23rd, 2018.  For older changelogs please consult the release tag on [GitHub](https://github.com/kipcole9/money/tags)



The primary purpose of this release is to support ex_cldr version 2.0



### Breaking changes



* `Money.from_tuple/1` has been removed

* Uses [ex_cldr](https://hex.pm/packages/ex_cldr/2.0.0) version 2.  Please see [the changelog](https://github.com/kipcole9/cldr/blob/v2.0.1/CHANGELOG.md#migrating-from-cldr-1x-to-cldr-version-2x) for configuration changes that are required.

* Requires a default_cldr_backend to be configured in `config.exs`.  For example:

```

  config :ex_money,

    ...

    default_cldr_backend: MyApp.Cldr

  end

```