Dinheiro v0.1.6 Dinheiro View Source

Build Status Coverage Status

Link to this section Summary

Types

t()

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

Return a new Dinheiro structs with value multiplied by other value. The first parameter must be a struct of Dinheiro

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 new Dinheiro structs with subtract of two values. The first parameter must be a struct of Dinheiro

Return a new Dinheiro structs with sum of two values. The first parameter must be a struct of Dinheiro

Return a float value from a Dinheiro structs

Return a formated string from a Dinheiro struct

Link to this section Types

Link to this type t() View Source
t() :: %Dinheiro{moeda: atom(), quantia: integer()}
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

Link to this function compare(a, b) View Source
compare(t(), t()) :: integer()

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
Link to this function divide(a, b) View Source
divide(t(), integer() | [integer()]) :: [t()]

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}]
Link to this function equals?(a, b) View Source
equals?(t(), t()) :: boolean()

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
Link to this function multiply(a, b) View Source
multiply(t(), integer() | float()) :: t()

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}
Link to this function new(quantia, moeda) View Source
new(integer() | float(), atom() | String.t()) :: t()

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}
Link to this function subtract(a, b) View Source
subtract(t(), t() | integer() | float()) :: t()

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}
Link to this function sum(a, b) View Source
sum(t(), t() | integer() | float()) :: t()

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}
Link to this function to_float(from) View Source
to_float(t()) :: float()

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
Link to this function to_string(from, opts \\ []) View Source
to_string(t(), Keywords.t()) :: String.t()

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 - default true, put to false to hide de currency symbol.
  • display_currency_code - default false, put to true 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"