Gem Version Build Status Code Climate Dependency Status License

A library for converting various objects into Money objects.



bundle add monetize

Or install it yourself as:

$ gem install monetize


Monetize.parse("USD 100") ==, "USD")
Monetize.parse("EUR 100") ==, "EUR")
Monetize.parse("GBP 100") ==, "GBP")

"100".to_money ==, "USD")

parse will return nil if it is unable to parse the input. Use parse! instead if you want a Monetize::Error (or one of the subclasses) to be raised instead:

>> Monetize.parse('OMG 100')
=> nil

>> Monetize.parse!('OMG 100')
Monetize::ParseError: Unknown currency 'omg'

Optionally, enable the ability to assume the currency from a passed symbol. Otherwise, currency symbols will be ignored, and USD used as the default currency:

Monetize.parse("£100") ==, "USD")

Monetize.assume_from_symbol = true

Monetize.parse("£100") ==, "GBP")
"€100".to_money ==, "EUR")

Parsing can be improved where the input is not expected to contain fractonal subunits. To do this, set Monetize.expect_whole_subunits = true

Monetize.parse('EUR 10,000') ==, "EUR")

Monetize.expect_whole_subunits = true
Monetize.parse('EUR 10,000') ==, "EUR")

Why does this work? If we expect fractional subunits then the parser will treat a single delimiter as a decimal marker if it matches the currency's decimal marker. But often this is not the case - a European site will show $10.000 because that's the local format. As a human, if this was a stock ticker we might expect fractional cents. If it's a retail price we know it's actually an incorrect thousands separator.

Monetize can also parse a list of values, returning an array-like object (Monetize::Collection):

Monetize.parse_collection("€80/$100") == [, "EUR"),, "USD")]
Monetize.parse_collection("€80, $100") == [, "EUR"),, "USD")]

# The #range? method detects the presence of a hyphen
Monetize.parse_collection("€80-$100").range? == true


See for details.