Dinheiro v0.1.6 Dinheiro View Source
Link to this section Summary
Types
Type that represents Dinheiro struct with:
:quantia as integer that represents an amount.
:moeda as atom that represents an ISO 4217 code
Functions
Compares two Dinheiro
structs with each other.
They must each be of the same moeda and then their value are compared
Divide a Dinheiro
struct by a positive integer value
Retun true
if two Dinheiro
structs are equals
Create a new Dinheiro
struct using a default currency.
The default currency can be set in the system Mix config
Create a new Dinheiro
struct
Return a float value from a Dinheiro
structs
Return a formated string from a Dinheiro
struct
Link to this section Types
Type that represents Dinheiro struct with:
:quantia as integer that represents an amount.
:moeda as atom that represents an ISO 4217 code.
Link to this section Functions
Compares two Dinheiro
structs with each other.
They must each be of the same moeda and then their value are compared.
Example:
iex> Dinheiro.compare(Dinheiro.new(12345, :BRL), Dinheiro.new(12345, :BRL))
0
iex> Dinheiro.compare(Dinheiro.new(12345, :BRL), Dinheiro.new(12346, :BRL))
-1
iex> Dinheiro.compare(Dinheiro.new(12346, :BRL), Dinheiro.new(12345, :BRL))
1
Divide a Dinheiro
struct by a positive integer value
Example:
iex> Dinheiro.divide(Dinheiro.new(100, :BRL), 2)
[%Dinheiro{quantia: 5000, moeda: :BRL}, %Dinheiro{quantia: 5000, moeda: :BRL}]
iex> Dinheiro.divide(Dinheiro.new(101, :BRL), 2)
[%Dinheiro{quantia: 5050, moeda: :BRL}, %Dinheiro{quantia: 5050, moeda: :BRL}]
Divide a Dinheiro
struct by an list of values that represents a division ratio.
Example:
iex> Dinheiro.divide(Dinheiro.new(0.05, :BRL), [3, 7])
[%Dinheiro{quantia: 2, moeda: :BRL}, %Dinheiro{quantia: 3, moeda: :BRL}]
Retun true
if two Dinheiro
structs are equals.
Example:
iex> Dinheiro.equals?(Dinheiro.new(12345, :BRL), Dinheiro.new(12345, :BRL))
true
iex> Dinheiro.equals?(Dinheiro.new(12345, :BRL), Dinheiro.new(12346, :BRL))
false
iex> Dinheiro.equals?(Dinheiro.new(12345, :BRL), Dinheiro.new(12345, :USD))
false
Return a new Dinheiro
structs with value multiplied by other value.
The first parameter must be a struct of Dinheiro
.
Example:
iex> Dinheiro.multiply(Dinheiro.new(2, :BRL), 2)
%Dinheiro{quantia: 400, moeda: :BRL}
iex> Dinheiro.multiply(Dinheiro.new(5, :BRL), 2.5)
%Dinheiro{quantia: 1250, moeda: :BRL}
iex> Dinheiro.multiply(Dinheiro.new(4, :BRL), -2)
%Dinheiro{quantia: -800, moeda: :BRL}
Create a new Dinheiro
struct using a default currency.
The default currency can be set in the system Mix config.
Example:
iex> Application.put_env(:ex_dinheiro, :default_currency, :BRL)
iex> Dinheiro.new(12345)
%Dinheiro{quantia: 1234500, moeda: :BRL}
iex> Dinheiro.new(123.45)
%Dinheiro{quantia: 12345, moeda: :BRL}
Create a new Dinheiro
struct.
Example:
iex> Dinheiro.new(12345, :BRL)
%Dinheiro{quantia: 1234500, moeda: :BRL}
iex> Dinheiro.new(12345, "BRL")
%Dinheiro{quantia: 1234500, moeda: :BRL}
iex> Dinheiro.new(123.45, :BRL)
%Dinheiro{quantia: 12345, moeda: :BRL}
iex> Dinheiro.new(123.45, "BRL")
%Dinheiro{quantia: 12345, moeda: :BRL}
Is possible to work with no official ISO currency code adding it in the system Mix config.
Examples
iex> Moeda.find(:XBT)
nil
iex> moedas = %{ XBT: %Moeda{nome: "Bitcoin", simbolo: '฿', codigo: "XBT", codigo_iso: 0, expoente: 8} }
iex> Application.put_env(:ex_dinheiro, :unofficial_currencies, moedas)
iex> Dinheiro.new(123.45, :XBT)
%Dinheiro{quantia: 12345000000, moeda: :XBT}
Return a new Dinheiro
structs with subtract of two values.
The first parameter must be a struct of Dinheiro
.
Example:
iex> Dinheiro.subtract(Dinheiro.new(2, :BRL), Dinheiro.new(1, :BRL))
%Dinheiro{quantia: 100, moeda: :BRL}
iex> Dinheiro.subtract(Dinheiro.new(4, :BRL), 2)
%Dinheiro{quantia: 200, moeda: :BRL}
iex> Dinheiro.subtract(Dinheiro.new(5, :BRL), 2.5)
%Dinheiro{quantia: 250, moeda: :BRL}
iex> Dinheiro.subtract(Dinheiro.new(4, :BRL), -2)
%Dinheiro{quantia: 600, moeda: :BRL}
Return a new Dinheiro
structs with sum of two values.
The first parameter must be a struct of Dinheiro
.
Example:
iex> Dinheiro.sum(Dinheiro.new(1, :BRL), Dinheiro.new(1, :BRL))
%Dinheiro{quantia: 200, moeda: :BRL}
iex> Dinheiro.sum(Dinheiro.new(1, :BRL), 2)
%Dinheiro{quantia: 300, moeda: :BRL}
iex> Dinheiro.sum(Dinheiro.new(1, :BRL), 2.5)
%Dinheiro{quantia: 350, moeda: :BRL}
iex> Dinheiro.sum(Dinheiro.new(2, :BRL), -1)
%Dinheiro{quantia: 100, moeda: :BRL}
Return a float value from a Dinheiro
structs.
Example:
iex> Dinheiro.to_float(%Dinheiro{quantia: 200, moeda: :BRL})
2.0
iex> Dinheiro.to_float(Dinheiro.new(50.5, :BRL))
50.5
iex> Dinheiro.to_float(Dinheiro.new(-4, :BRL))
-4.0
Return a formated string from a Dinheiro
struct.
Example:
iex> Dinheiro.to_string(%Dinheiro{quantia: 200, moeda: :BRL})
"R$ 2,00"
iex> Dinheiro.to_string(Dinheiro.new(50.5, :BRL))
"R$ 50,50"
iex> Dinheiro.to_string(Dinheiro.new(-4, :BRL))
"R$ -4,00"
Using options-style parameters you can change the behavior of the function.
thousand_separator
- default"."
, sets the thousand separator.decimal_separator
- default","
, sets the decimal separator.display_currency_symbol
- defaulttrue
, put tofalse
to hide de currency symbol.display_currency_code
- defaultfalse
, put totrue
to display de currency ISO 4217 code.
Exemples
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :USD), thousand_separator: ",", decimal_separator: ".")
"$ 1,000.50"
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :USD), display_currency_symbol: false)
"1.000,50"
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :USD), display_currency_code: true)
"$ 1.000,50 USD"
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :USD), display_currency_code: true, display_currency_symbol: false)
"1.000,50 USD"
The default values also can be set in the system Mix config.
Example:
iex> Application.put_env(:ex_dinheiro, :thousand_separator, ",")
iex> Application.put_env(:ex_dinheiro, :decimal_separator, ".")
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :USD))
"$ 1,000.50"
iex> Application.put_env(:ex_dinheiro, :display_currency_symbol, false)
iex> Dinheiro.to_string(Dinheiro.new(5000.5, :USD))
"5,000.50"
iex> Application.put_env(:ex_dinheiro, :display_currency_code, true)
iex> Dinheiro.to_string(Dinheiro.new(10000.0, :USD))
"10,000.00 USD"
The options-style parameters override values in the system Mix config.
Example:
iex> Application.put_env(:ex_dinheiro, :thousand_separator, ",")
iex> Application.put_env(:ex_dinheiro, :decimal_separator, ".")
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :USD))
"$ 1,000.50"
iex> Dinheiro.to_string(Dinheiro.new(1000.5, :BRL), thousand_separator: ".", decimal_separator: ",")
"R$ 1.000,50"
Is possible to override some official ISO currency code adding it in the system Mix config.
Examples
iex> Dinheiro.to_string(Dinheiro.new(12_345_678.9, :BRL))
"R$ 12.345.678,90"
iex> Dinheiro.to_string(Dinheiro.new(12_345_678.9, :USD))
"$ 12.345.678,90"
iex> Dinheiro.to_string(Dinheiro.new(12_345_678.9, :XBT))
** (ArgumentError) to use Dinheiro.new/2 you must set a valid value to moeda.
iex> real = %Moeda{nome: "Moeda do Brasil", simbolo: 'BR$', codigo: "BRL", codigo_iso: 986, expoente: 4}
%Moeda{nome: "Moeda do Brasil", simbolo: 'BR$', codigo: "BRL", codigo_iso: 986, expoente: 4}
iex> dollar = %Moeda{nome: "Moeda do EUA", simbolo: 'US$', codigo: "USD", codigo_iso: 840, expoente: 3}
%Moeda{nome: "Moeda do EUA", simbolo: 'US$', codigo: "USD", codigo_iso: 840, expoente: 3}
iex> bitcoin = %Moeda{nome: "Bitcoin", simbolo: '฿', codigo: "XBT", codigo_iso: 0, expoente: 8}
%Moeda{nome: "Bitcoin", simbolo: '฿', codigo: "XBT", codigo_iso: 0, expoente: 8}
iex> moedas = %{ BRL: real, USD: dollar, XBT: bitcoin }
iex> Application.put_env(:ex_dinheiro, :unofficial_currencies, moedas)
iex> Dinheiro.to_string(Dinheiro.new(12_345_678.9, :BRL))
"BR$ 12.345.678,9000"
iex> Dinheiro.to_string(Dinheiro.new(12_345_678.9, :usd))
"US$ 12.345.678,900"
iex> Dinheiro.to_string(Dinheiro.new(12_345_678.9, "XBT"))
"฿ 12.345.678,90000000"