Creates a new Money object of value given as an amount of the given currency (as fractional if Int, or whole amount otherwise).

Money.new                      # => Money(@amount=0.0 @currency="USD")
Money.new(1_50)                # => Money(@amount=1.5 @currency="USD")
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")

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

Returns a proc that sets the Fiber.current#money_context to the current context (copied from the current fiber - references will be shared though) and then calls the given block. Useful when you need to spawn a new fiber later with the same context as the current fiber.

Money.default_currency = "PLN"

spawn &Money.same_context_wrapper(&block)
# or
spawn &Money.same_context_wrapper do
  Money.default_currency.code # => "PLN"
end

NOTE The proc will not set the context back to the original value.

See also #spawn_with_same_context.

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, bank, rate_store} properties will be shared between the current fiber and the spawned fiber.

See also #same_context_wrapper.

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.

Compares two Money objects.

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.

The Bank object which currency exchanges are performed with.

NOTE Will return Money.default_bank if set to nil (the default).

The Bank object which currency exchanges are performed with.

NOTE Will return Money.default_bank if set to nil (the default).

Alias of #fractional.

The money's currency.

Alias of #amount.

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.

Returns hash value based on the #amount and #currency attributes.

Returns the nearest possible amount in cash value (cents).

For example, in Swiss franc (CHF), the smallest possible amount of cash value is CHF 0.05. Therefore, for CHF 0.07 this method returns CHF 0.05, and for CHF 0.08, CHF 0.10.

See also #rounded_to_nearest_cash_value and Currency#smallest_denomination.

Rounds the monetary amount to smallest unit of coinage, using rounding mode if given, or Money.rounding_mode otherwise.

Money.new(10.1, "USD").round                   # => Money(@amount=10.0, @currency="USD")
Money.new(10.5, "USD").round(mode: :ties_even) # => Money(@amount=10.0, @currency="USD")
Money.new(10.5, "USD").round(mode: :ties_away) # => Money(@amount=11.0, @currency="USD")

Returns a new Money instance with the nearest possible amount in cash value.

See also #nearest_cash_value.

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.