Creates a new Money object of value given as an fractional amount of the given currency.

Money.new(0, "USD")    # => Money(@amount=0.0 @currency="USD")
Money.new(1_50, "USD") # => Money(@amount=1.5 @currency="USD")

Creates a new Money object of value given as an whole amount of the given currency.

Money.new(1.5, "USD")          # => Money(@amount=1.5 @currency="USD")
Money.new(1.5.to_big_d, "USD") # => Money(@amount=1.5 @currency="USD")

WARNING Floating points cannot guarantee precision. Therefore, they should only be used when you no longer need to represent currency or working with another system that requires floats.

Creates a new Money object of value given as an amount of the given currency.

Money.new(amount: 13.37) # => Money(@amount=13.37)

Creates a new Money object of value given as a fractional of the given currency.

Money.new(fractional: 13_37) # => Money(@amount=13.37)

Yields the given block with the current Money.context as an argument.

Money.configure do |context|
  context.infinite_precision = true
  context.default_currency = "EUR"
end

Sets the default exchange to be a Currency::Exchange::SingleCurrency exchange that raises on currency exchange. Useful when apps operate in a single currency at a time.

Spawns a new fiber with the Money::Context copied from the current fiber.

Money.default_currency.code # => "USD"
Money.default_currency = "PLN"

spawn do
  Money.default_currency.code # => "USD"
end

# vs

Money.spawn_with_same_context do
  Money.default_currency.code # => "PLN"
end

NOTE References to the #default_{currency, exchange, rate_store} properties will be shared between the current fiber and the spawned fiber.

Sets the given infinite precision value within the lifetime of the given block.

See also Money.infinite_precision?.

Sets the given rounding mode within the lifetime of the given block.

See also Money.rounding_mode.

Disallows currency conversion within the lifetime of the given block.

See also Money.disallow_currency_conversion!.

Compares two Money objects. Returns 0 if the two objects are equal, a negative number if this object is considered less than other or a positive number if this object is considered greater than other.

NOTE Two Money objects with 0 amount are considered equal, regardless of their currency.

NOTE Performs currency conversion if necessary.

Compares two Money objects. Returns true if self is equal to other, false otherwise.

NOTE Two Money objects with 0 amount are considered equal, regardless of their currency.

NOTE Performs currency conversion if necessary.

Returns the numerical value of the money.

Money.new(1_00, "USD").amount # => 1.0

See also #fractional, Money.infinite_precision? and Money.rounding_mode.

Alias of #fractional.

The money's currency.

The value of the monetary amount represented in the fractional or subunit of the currency.

For example, in the US dollar currency the fractional unit is cents, and there are 100 cents in one US dollar. So given the Money representation of one US dollar, the fractional interpretation is 100.

Another example is that of the Kuwaiti dinar. In this case the fractional unit is the fils and there 1000 fils to one Kuwaiti dinar. So given the Money representation of one Kuwaiti dinar, the fractional interpretation is 1000.

See also Money.infinite_precision? and Money.rounding_mode.

See Object#hash(hasher)

Returns a new Money instance with incremented #fractional value.

Money.new(1_00, "USD").succ # => Money(@amount=1.01 @currency="USD")
Money.new(1, "JPY").succ    # => Money(@amount=2.0 @currency="JPY")

Returns a new Money instance in a given currency - if it's different from the current #currency - or self otherwise, leaving the amount intact and not performing currency conversion.