slouchpie
kip
ex_cldr Core Team
I do try to be as clear as possible in documentation about the purpose and intent of ex_money. Always happy to accept a PR that makes it clearer! (I’m the author).
Introduction to Money
Money implements a set of functions to store, retrieve, convert and perform arithmetic
on a %Money{} type that is composed of an ISO 4217 currency code and a currency amount.
Money is opinionated in the interests of serving as a dependable library that can underpin accounting and financial applications.
How is this opinion expressed?
-
Money must always have both a amount and a currency code.
-
The currency code must always be a valid ISO4217 code. Current and historical currency codes can be used. See the ISO Currency for more information. You can also identify the relevant codes by:
Money.known_currencies/0returns all the currency codes known toMoneyMoney.known_current_currencies/0returns the currency codes currently in useMoney.known_historic_currencies/0returns the list of historic currency codesMoney.known_tender_currencies/0returns the list of currencies known to be legal tender
-
Money arithmetic can only be performed when both operands are of the same currency.
-
Money amounts are represented as a
Decimal. -
Money can be serialised to the database as a composite Postgres type that includes both the amount and the currency. For MySQL, money is serialized into a json column with the amount converted to a string to preserve precision since json does not have a decimal type. Serialization is entirely optional.
-
All arithmetic functions work on a
Decimal. No rounding occurs automatically (unless expressly called out for a function, as is the case forMoney.split/2). -
Explicit rounding obeys the rounding rules for a given currency. The rounding rules are defined by the Unicode consortium in its CLDR repository as implemented by the hex package ex_cldr. These rules define the number of fractional digits for a currency and the rounding increment where appropriate.
-
Money output string formatting output using the hex package ex_cldr that correctly rounds to the appropriate number of fractional digits and to the correct rounding increment for currencies that have minimum cash increments (like the Swiss Franc and Australian Dollar)
14
slouchpie
I think the only thing lacking is for each library to make some reference to the other.
For example…
:money could have this in its README
Looking for something more comprehensive and globally applicable? Look at
:ex_money
and :ex_money could have this in its README
Looking for something simple and lighter without any
:cldrdeps? Look at:money
something like that?
3
lukaszsamson
ElixirLS Core Team
In my company (fintech domain) mostly Decimal as integrates nicely with ecto. The library used to be buggy (I and my coworkers authored a few PRs) but that’s no longer the case. The biggest problem with Decimal now is performance. In case of performance sensitive code we use plain old integers or even NIFs.
0