Money (Joda money 0.9 API)

Every currency has a certain standard number of decimal places. This is typically 2 (Euro, British Pound, US Dollar) but might be 0 (Japanese Yen), 1 (Vietnamese Dong) or 3 (Bahrain Dinar). The Money class is fixed to this number of decimal places.

For example, US dollars has a standard number of decimal places of 2. The major units are dollars. The minor units are cents, 100 to the dollar. This class does not allow calculations on fractions of a cent.

This class is immutable and thread-safe.

See Also:: Serialized Form

Method Summary
`Money`	`abs()` Returns a copy of this monetary value with a positive amount.
`int`	`compareTo(BigMoneyProvider other)` Compares this monetary value to another.
`Money`	`convertedTo(CurrencyUnit currency, BigDecimal conversionMultipler, RoundingMode roundingMode)` Returns a copy of this monetary value converted into another currency using the specified conversion rate, with a rounding mode used to adjust the decimal places in the result.
`Money`	`dividedBy(BigDecimal valueToDivideBy, RoundingMode roundingMode)` Returns a copy of this monetary value divided by the specified value.
`Money`	`dividedBy(double valueToDivideBy, RoundingMode roundingMode)` Returns a copy of this monetary value divided by the specified value.
`Money`	`dividedBy(long valueToDivideBy, RoundingMode roundingMode)` Returns a copy of this monetary value divided by the specified value.
`boolean`	`equals(Object other)` Checks if this monetary value equals another.
`BigDecimal`	`getAmount()` Gets the amount.
`BigDecimal`	`getAmountMajor()` Gets the amount in major units as a `BigDecimal` with scale 0.
`int`	`getAmountMajorInt()` Gets the amount in major units as an `int`.
`long`	`getAmountMajorLong()` Gets the amount in major units as a `long`.
`BigDecimal`	`getAmountMinor()` Gets the amount in minor units as a `BigDecimal` with scale 0.
`int`	`getAmountMinorInt()` Gets the amount in minor units as an `int`.
`long`	`getAmountMinorLong()` Gets the amount in minor units as a `long`.
`CurrencyUnit`	`getCurrencyUnit()` Gets the currency.
`int`	`getMinorPart()` Gets the minor part of the amount.
`int`	`getScale()` Gets the scale of the `BigDecimal` amount.
`int`	`hashCode()` Returns a hash code for this monetary value.
`boolean`	`isEqual(BigMoneyProvider other)` Checks if this monetary value is equal to another.
`boolean`	`isGreaterThan(BigMoneyProvider other)` Checks if this monetary value is greater than another.
`boolean`	`isLessThan(BigMoneyProvider other)` Checks if this monetary value is less than another.
`boolean`	`isNegative()` Checks if the amount is less than zero.
`boolean`	`isNegativeOrZero()` Checks if the amount is zero or less.
`boolean`	`isPositive()` Checks if the amount is greater than zero.
`boolean`	`isPositiveOrZero()` Checks if the amount is zero or greater.
`boolean`	`isSameCurrency(BigMoneyProvider other)` Checks if this instance and the specified instance have the same currency.
`boolean`	`isZero()` Checks if the amount is zero.
`Money`	`minus(BigDecimal amountToSubtract)` Returns a copy of this monetary value with the amount subtracted.
`Money`	`minus(BigDecimal amountToSubtract, RoundingMode roundingMode)` Returns a copy of this monetary value with the amount subtracted.
`Money`	`minus(double amountToSubtract)` Returns a copy of this monetary value with the amount subtracted.
`Money`	`minus(double amountToSubtract, RoundingMode roundingMode)` Returns a copy of this monetary value with the amount subtracted.
`Money`	`minus(Iterable<Money> moniesToSubtract)` Returns a copy of this monetary value with a collection of monetary amounts subtracted.
`Money`	`minus(Money moneyToSubtract)` Returns a copy of this monetary value with the amount subtracted.
`Money`	`minusMajor(long amountToSubtract)` Returns a copy of this monetary value with the amount in major units subtracted.
`Money`	`minusMinor(long amountToSubtract)` Returns a copy of this monetary value with the amount in minor units subtracted.
`Money`	`multipliedBy(BigDecimal valueToMultiplyBy, RoundingMode roundingMode)` Returns a copy of this monetary value multiplied by the specified value.
`Money`	`multipliedBy(double valueToMultiplyBy, RoundingMode roundingMode)` Returns a copy of this monetary value multiplied by the specified value.
`Money`	`multipliedBy(long valueToMultiplyBy)` Returns a copy of this monetary value multiplied by the specified value.
`Money`	`negated()` Returns a copy of this monetary value with the amount negated.
`static Money`	`nonNull(Money money, CurrencyUnit currency)` Ensures that a `Money` is not `null`.
`static Money`	`of(BigMoneyProvider moneyProvider)` Obtains an instance of `Money` from a provider.
`static Money`	`of(BigMoneyProvider moneyProvider, RoundingMode roundingMode)` Obtains an instance of `Money` from a provider, rounding as necessary.
`static Money`	`of(CurrencyUnit currency, BigDecimal amount)` Obtains an instance of `Money` from a `BigDecimal`.
`static Money`	`of(CurrencyUnit currency, BigDecimal amount, RoundingMode roundingMode)` Obtains an instance of `Money` from a `BigDecimal`, rounding as necessary.
`static Money`	`of(CurrencyUnit currency, double amount)` Obtains an instance of `Money` from a `double` using a well-defined conversion.
`static Money`	`of(CurrencyUnit currency, double amount, RoundingMode roundingMode)` Obtains an instance of `Money` from a `double` using a well-defined conversion, rounding as necessary.
`static Money`	`ofMajor(CurrencyUnit currency, long amountMajor)` Obtains an instance of `Money` from an amount in major units.
`static Money`	`ofMinor(CurrencyUnit currency, long amountMinor)` Obtains an instance of `Money` from an amount in minor units.
`static Money`	`parse(String moneyStr)` Parses an instance of `Money` from a string.
`Money`	`plus(BigDecimal amountToAdd)` Returns a copy of this monetary value with the amount added.
`Money`	`plus(BigDecimal amountToAdd, RoundingMode roundingMode)` Returns a copy of this monetary value with the amount added.
`Money`	`plus(double amountToAdd)` Returns a copy of this monetary value with the amount added.
`Money`	`plus(double amountToAdd, RoundingMode roundingMode)` Returns a copy of this monetary value with the amount added.
`Money`	`plus(Iterable<Money> moniesToAdd)` Returns a copy of this monetary value with a collection of monetary amounts added.
`Money`	`plus(Money moneyToAdd)` Returns a copy of this monetary value with the amount added.
`Money`	`plusMajor(long amountToAdd)` Returns a copy of this monetary value with the amount in major units added.
`Money`	`plusMinor(long amountToAdd)` Returns a copy of this monetary value with the amount in minor units added.
`Money`	`rounded(int scale, RoundingMode roundingMode)` Returns a copy of this monetary value rounded to the specified scale without changing the current scale.
`BigMoney`	`toBigMoney()` Implements the `BigMoneyProvider` interface, returning a `BigMoney` instance with the same currency, amount and scale.
`String`	`toString()` Gets the monetary value as a string.
`static Money`	`total(CurrencyUnit currency, Iterable<Money> monies)` Obtains an instance of `Money` as the total value of a possibly empty collection.
`static Money`	`total(CurrencyUnit currency, Money... monies)` Obtains an instance of `Money` as the total value of a possibly empty array.
`static Money`	`total(Iterable<Money> monies)` Obtains an instance of `Money` as the total value of a collection.
`static Money`	`total(Money... monies)` Obtains an instance of `Money` as the total value of an array.
`Money`	`withAmount(BigDecimal amount)` Returns a copy of this monetary value with the specified amount.
`Money`	`withAmount(BigDecimal amount, RoundingMode roundingMode)` Returns a copy of this monetary value with the specified amount.
`Money`	`withAmount(double amount)` Returns a copy of this monetary value with the specified amount using a well-defined conversion from a `double`.
`Money`	`withAmount(double amount, RoundingMode roundingMode)` Returns a copy of this monetary value with the specified amount using a well-defined conversion from a `double`.
`Money`	`withCurrencyUnit(CurrencyUnit currency)` Returns a copy of this monetary value with the specified currency.
`Money`	`withCurrencyUnit(CurrencyUnit currency, RoundingMode roundingMode)` Returns a copy of this monetary value with the specified currency.
`static Money`	`zero(CurrencyUnit currency)` Obtains an instance of `Money` representing zero.

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Method Detail

of

public static Money of(CurrencyUnit currency,
                       BigDecimal amount)

Obtains an instance of Money from a BigDecimal.

This allows you to create an instance with a specific currency and amount. No rounding is performed on the amount, so it must have a scale compatible with the currency.

Parameters:: currency - the currency, not null; amount - the amount of money, not null
Returns:: the new instance, never null
Throws:: ArithmeticException - if the scale exceeds the currency scale

of

public static Money of(CurrencyUnit currency,
                       BigDecimal amount,
                       RoundingMode roundingMode)

Obtains an instance of Money from a BigDecimal, rounding as necessary.

This allows you to create an instance with a specific currency and amount. If the amount has a scale in excess of the scale of the currency then the excess fractional digits are rounded using the rounding mode.

Parameters:: currency - the currency, not null; amount - the amount of money, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance, never null
Throws:: ArithmeticException - if the rounding fails

of

public static Money of(CurrencyUnit currency,
                       double amount)

Obtains an instance of Money from a double using a well-defined conversion.

This allows you to create an instance with a specific currency and amount. No rounding is performed on the amount, so it must have a scale compatible with the currency.

The amount is converted via BigDecimal.valueOf(double) which yields the most expected answer for most programming scenarios. Any double literal in code will be converted to exactly the same BigDecimal with the same scale. For example, the literal '1.45d' will be converted to '1.45'.

Parameters:: currency - the currency, not null; amount - the amount of money, not null
Returns:: the new instance, never null
Throws:: ArithmeticException - if the scale exceeds the currency scale

of

public static Money of(CurrencyUnit currency,
                       double amount,
                       RoundingMode roundingMode)

Obtains an instance of Money from a double using a well-defined conversion, rounding as necessary.

Parameters:: currency - the currency, not null; amount - the amount of money, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance, never null
Throws:: ArithmeticException - if the rounding fails

ofMajor

public static Money ofMajor(CurrencyUnit currency,
                            long amountMajor)

Obtains an instance of Money from an amount in major units.

This allows you to create an instance with a specific currency and amount. The amount is a whole number only. Thus you can initialise the value 'USD 20', but not the value 'USD 20.32'. For example, ofMajor(USD, 25) creates the instance USD 25.00.

Parameters:: currency - the currency, not null; amountMajor - the amount of money in the major division of the currency
Returns:: the new instance, never null

ofMinor

public static Money ofMinor(CurrencyUnit currency,
                            long amountMinor)

Obtains an instance of Money from an amount in minor units.

This allows you to create an instance with a specific currency and amount expressed in terms of the minor unit. For example, if constructing US Dollars, the input to this method represents cents. Note that when a currency has zero decimal places, the major and minor units are the same. For example, ofMajor(USD, 2595) creates the instance USD 25.95.

Parameters:: currency - the currency, not null; amountMinor - the amount of money in the minor division of the currency
Returns:: the new instance, never null

zero

public static Money zero(CurrencyUnit currency)

Obtains an instance of Money representing zero.

For example, zero(USD) creates the instance USD 0.00.

Parameters:: currency - the currency, not null
Returns:: the instance representing zero, never null

of

public static Money of(BigMoneyProvider moneyProvider)

Obtains an instance of Money from a provider.

This allows you to create an instance from any class that implements the provider, such as BigMoney. No rounding is performed on the amount, so it must have a scale compatible with the currency.

Parameters:: moneyProvider - the money to convert, not null
Returns:: the new instance, never null
Throws:: ArithmeticException - if the scale exceeds the currency scale

of

public static Money of(BigMoneyProvider moneyProvider,
                       RoundingMode roundingMode)

Obtains an instance of Money from a provider, rounding as necessary.

This allows you to create an instance from any class that implements the provider, such as BigMoney. The rounding mode is used to adjust the scale to the scale of the currency.

Parameters:: moneyProvider - the money to convert, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance, never null
Throws:: ArithmeticException - if the rounding fails

total

public static Money total(Money... monies)

Obtains an instance of Money as the total value of an array.

The array must contain at least one monetary value. Subsequent amounts are added as though using plus(Money). All amounts must be in the same currency.

Parameters:: monies - the monetary values to total, not empty, no null elements, not null
Returns:: the total, never null
Throws:: IllegalArgumentException - if the array is empty; CurrencyMismatchException - if the currencies differ

total

public static Money total(Iterable<Money> monies)

Obtains an instance of Money as the total value of a collection.

The iterable must provide at least one monetary value. Subsequent amounts are added as though using plus(Money). All amounts must be in the same currency.

Parameters:: monies - the monetary values to total, not empty, no null elements, not null
Returns:: the total, never null
Throws:: IllegalArgumentException - if the iterable is empty; CurrencyMismatchException - if the currencies differ

total

public static Money total(CurrencyUnit currency,
                          Money... monies)

Obtains an instance of Money as the total value of a possibly empty array.

The amounts are added as though using plus(Money) starting from zero in the specified currency. All amounts must be in the same currency.

Parameters:: currency - the currency to total in, not null; monies - the monetary values to total, no null elements, not null
Returns:: the total, never null
Throws:: CurrencyMismatchException - if the currencies differ

total

public static Money total(CurrencyUnit currency,
                          Iterable<Money> monies)

Obtains an instance of Money as the total value of a possibly empty collection.

The amounts are added as though using plus(Money) starting from zero in the specified currency. All amounts must be in the same currency.

Parameters:: currency - the currency to total in, not null; monies - the monetary values to total, no null elements, not null
Returns:: the total, never null
Throws:: CurrencyMismatchException - if the currencies differ

parse

public static Money parse(String moneyStr)

Parses an instance of Money from a string.

The string format is ' '. The currency code must be a valid three letter currency. The amount must match the regular expression [+-]?[0-9]*[.]?[0-9]*. This matches the output from toString().

For example, of("USD 25") creates the instance USD 25.00 while of("USD 25.95") creates the instance USD 25.95.

Parameters:: moneyStr - the money string to parse, not null
Returns:: the parsed instance, never null
Throws:: IllegalArgumentException - if the string is malformed; ArithmeticException - if the amount is too large

nonNull

public static Money nonNull(Money money,
                            CurrencyUnit currency)

Ensures that a Money is not null.

If the input money is not null, then it is returned, providing that the currency matches the specified currency. If the input money is null, then zero money in the currency is returned.

Parameters:: money - the monetary value to check, may be null; currency - the currency to use, not null
Returns:: the input money or zero in the specified currency, never null
Throws:: CurrencyMismatchException - if the input money is non-null and the currencies differ

getCurrencyUnit

public CurrencyUnit getCurrencyUnit()

Gets the currency.

Returns:: the currency, never null

withCurrencyUnit

public Money withCurrencyUnit(CurrencyUnit currency)

Returns a copy of this monetary value with the specified currency.

The returned instance will have the specified currency and the amount from this instance. If the scale differs between the currencies such that rounding would be required, then an exception is thrown.

This instance is immutable and unaffected by this method.

Parameters:: currency - the currency to use, not null
Returns:: the new instance with the input currency set, never null
Throws:: ArithmeticException - if the scale of the new currency is less than the scale of this currency

withCurrencyUnit

public Money withCurrencyUnit(CurrencyUnit currency,
                              RoundingMode roundingMode)

Returns a copy of this monetary value with the specified currency.

The returned instance will have the specified currency and the amount from this instance. If the number of decimal places differs between the currencies, then the amount may be rounded.

This instance is immutable and unaffected by this method.

Parameters:: currency - the currency to use, not null; roundingMode - the rounding mode to use to bring the decimal places back in line, not null
Returns:: the new instance with the input currency set, never null
Throws:: ArithmeticException - if the rounding fails

getScale

public int getScale()

Gets the scale of the BigDecimal amount.

The scale has the same meaning as in BigDecimal. Positive values represent the number of decimal places in use. For example, a scale of 2 means that the money will have two decimal places such as 'USD 43.25'.

For Money, the scale is fixed and always matches that of the currency.

Returns:: the scale in use, typically 2 but could be 0, 1 and 3

getAmount

public BigDecimal getAmount()

Gets the amount.

This returns the value of the money as a BigDecimal. The scale will be the scale of this money.

Returns:: the amount, never null

getAmountMajor

public BigDecimal getAmountMajor()

Gets the amount in major units as a BigDecimal with scale 0.

This returns the monetary amount in terms of the major units of the currency, truncating the amount if necessary. For example, 'EUR 2.35' will return 2, and 'BHD -1.345' will return -1.

This is returned as a BigDecimal rather than a BigInteger. This is to allow further calculations to be performed on the result. Should you need a BigInteger, simply call BigDecimal.toBigInteger().

Returns:: the major units part of the amount, never null

getAmountMajorLong

public long getAmountMajorLong()

Gets the amount in major units as a long.

This returns the monetary amount in terms of the major units of the currency, truncating the amount if necessary. For example, 'EUR 2.35' will return 2, and 'BHD -1.345' will return -1.

Returns:: the major units part of the amount
Throws:: ArithmeticException - if the amount is too large for a long

getAmountMajorInt

public int getAmountMajorInt()

Gets the amount in major units as an int.

This returns the monetary amount in terms of the major units of the currency, truncating the amount if necessary. For example, 'EUR 2.35' will return 2, and 'BHD -1.345' will return -1.

Returns:: the major units part of the amount
Throws:: ArithmeticException - if the amount is too large for an int

getAmountMinor

public BigDecimal getAmountMinor()

Gets the amount in minor units as a BigDecimal with scale 0.

This returns the monetary amount in terms of the minor units of the currency, truncating the amount if necessary. For example, 'EUR 2.35' will return 235, and 'BHD -1.345' will return -1345.

Returns:: the minor units part of the amount, never null

getAmountMinorLong

public long getAmountMinorLong()

Gets the amount in minor units as a long.

This returns the monetary amount in terms of the minor units of the currency, truncating the amount if necessary. For example, 'EUR 2.35' will return 235, and 'BHD -1.345' will return -1345.

Returns:: the minor units part of the amount
Throws:: ArithmeticException - if the amount is too large for a long

getAmountMinorInt

public int getAmountMinorInt()

Gets the amount in minor units as an int.

This returns the monetary amount in terms of the minor units of the currency, truncating the amount if necessary. For example, 'EUR 2.35' will return 235, and 'BHD -1.345' will return -1345.

Returns:: the minor units part of the amount
Throws:: ArithmeticException - if the amount is too large for an int

getMinorPart

public int getMinorPart()

Gets the minor part of the amount.

This return the minor unit part of the monetary amount. This is defined as the amount in minor units excluding major units.

For example, EUR has a scale of 2, so the minor part is always between 0 and 99 for positive amounts, and 0 and -99 for negative amounts. Thus 'EUR 2.35' will return 35, and 'EUR -1.34' will return -34.

Returns:: the minor part of the amount, negative if the amount is negative

isZero

public boolean isZero()

Checks if the amount is zero.

Returns:: true if the amount is zero

isPositive

public boolean isPositive()

Checks if the amount is greater than zero.

Returns:: true if the amount is greater than zero

isPositiveOrZero

public boolean isPositiveOrZero()

Checks if the amount is zero or greater.

Returns:: true if the amount is zero or greater

isNegative

public boolean isNegative()

Checks if the amount is less than zero.

Returns:: true if the amount is less than zero

isNegativeOrZero

public boolean isNegativeOrZero()

Checks if the amount is zero or less.

Returns:: true if the amount is zero or less

withAmount

public Money withAmount(BigDecimal amount)

Returns a copy of this monetary value with the specified amount.

The returned instance will have this currency and the new amount. No rounding is performed on the amount to be added, so it must have a scale compatible with the currency.

This instance is immutable and unaffected by this method.

Parameters:: amount - the monetary amount to set in the returned instance, not null
Returns:: the new instance with the input amount set, never null
Throws:: ArithmeticException - if the scale of the amount is too large

withAmount

public Money withAmount(BigDecimal amount,
                        RoundingMode roundingMode)

Returns a copy of this monetary value with the specified amount.

The returned instance will have this currency and the new amount. If the scale of the BigDecimal needs to be adjusted, then it will be rounded using the specified mode.

This instance is immutable and unaffected by this method.

Parameters:: amount - the monetary amount to set in the returned instance, not null; roundingMode - the rounding mode to adjust the scale, not null
Returns:: the new instance with the input amount set, never null

withAmount

public Money withAmount(double amount)

Returns a copy of this monetary value with the specified amount using a well-defined conversion from a double.

The returned instance will have this currency and the new amount. No rounding is performed on the amount to be added, so it must have a scale compatible with the currency.

This instance is immutable and unaffected by this method.

Parameters:: amount - the monetary amount to set in the returned instance, not null
Returns:: the new instance with the input amount set, never null
Throws:: ArithmeticException - if the scale of the amount is too large

withAmount

public Money withAmount(double amount,
                        RoundingMode roundingMode)

Returns a copy of this monetary value with the specified amount using a well-defined conversion from a double.

The returned instance will have this currency and the new amount. If the scale of the BigDecimal needs to be adjusted, then it will be rounded using the specified mode.

This instance is immutable and unaffected by this method.

Parameters:: amount - the monetary amount to set in the returned instance, not null; roundingMode - the rounding mode to adjust the scale, not null
Returns:: the new instance with the input amount set, never null

plus

public Money plus(Iterable<Money> moniesToAdd)

Returns a copy of this monetary value with a collection of monetary amounts added.

This adds the specified amounts to this monetary amount, returning a new object. The amounts must be in the same currency.

This instance is immutable and unaffected by this method.

Parameters:: moniesToAdd - the monetary values to add, no null elements, not null
Returns:: the new instance with the input amounts added, never null
Throws:: CurrencyMismatchException - if the currencies differ

plus

public Money plus(Money moneyToAdd)

Returns a copy of this monetary value with the amount added.

This adds the specified amount to this monetary amount, returning a new object. The amount added must be in the same currency.

The addition has no rounding issues and is always accurate. For example,'USD 25.95' plus 'USD 3.02' will 'USD 28.97'.

This instance is immutable and unaffected by this method.

Parameters:: moneyToAdd - the monetary value to add, not null
Returns:: the new instance with the input amount added, never null
Throws:: CurrencyMismatchException - if the currencies differ

plus

public Money plus(BigDecimal amountToAdd)

Returns a copy of this monetary value with the amount added.

This adds the specified amount to this monetary amount, returning a new object. No rounding is performed on the amount to be added, so it must have a scale compatible with the currency.

This instance is immutable and unaffected by this method.

Parameters:: amountToAdd - the monetary value to add, not null
Returns:: the new instance with the input amount added, never null
Throws:: ArithmeticException - if the scale of the amount is too large

plus

public Money plus(BigDecimal amountToAdd,
                  RoundingMode roundingMode)

Returns a copy of this monetary value with the amount added.

This adds the specified amount to this monetary amount, returning a new object. If the amount to add exceeds the scale of the currency, then the rounding mode will be used to adjust the result.

This instance is immutable and unaffected by this method.

Parameters:: amountToAdd - the monetary value to add, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance with the input amount added, never null

plus

public Money plus(double amountToAdd)

Returns a copy of this monetary value with the amount added.

This adds the specified amount to this monetary amount, returning a new object. No rounding is performed on the amount to be added, so it must have a scale compatible with the currency.

This instance is immutable and unaffected by this method.

Parameters:: amountToAdd - the monetary value to add, not null
Returns:: the new instance with the input amount added, never null
Throws:: ArithmeticException - if the scale of the amount is too large

plus

public Money plus(double amountToAdd,
                  RoundingMode roundingMode)

Returns a copy of this monetary value with the amount added.

This adds the specified amount to this monetary amount, returning a new object. If the amount to add exceeds the scale of the currency, then the rounding mode will be used to adjust the result.

This instance is immutable and unaffected by this method.

Parameters:: amountToAdd - the monetary value to add, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance with the input amount added, never null

plusMajor

public Money plusMajor(long amountToAdd)

Returns a copy of this monetary value with the amount in major units added.

This adds an amount in major units, leaving the minor units untouched. For example, USD 23.45 plus 138 gives USD 161.45.

This instance is immutable and unaffected by this method.

Parameters:: amountToAdd - the monetary value to add, not null
Returns:: the new instance with the input amount added, never null

plusMinor

public Money plusMinor(long amountToAdd)

Returns a copy of this monetary value with the amount in minor units added.

This adds an amount in minor units. For example, USD 23.45 plus 138 gives USD 24.83.

This instance is immutable and unaffected by this method.

Parameters:: amountToAdd - the monetary value to add, not null
Returns:: the new instance with the input amount added, never null

minus

public Money minus(Iterable<Money> moniesToSubtract)

Returns a copy of this monetary value with a collection of monetary amounts subtracted.

This subtracts the specified amounts from this monetary amount, returning a new object. The amounts must be in the same currency.

This instance is immutable and unaffected by this method.

Parameters:: moniesToSubtract - the monetary values to subtract, no null elements, not null
Returns:: the new instance with the input amounts subtracted, never null
Throws:: CurrencyMismatchException - if the currencies differ

minus

public Money minus(Money moneyToSubtract)

Returns a copy of this monetary value with the amount subtracted.

This subtracts the specified amount from this monetary amount, returning a new object. The amount subtracted must be in the same currency.

The subtraction has no rounding issues and is always accurate. For example,'USD 25.95' minus 'USD 3.02' will 'USD 22.93'.

This instance is immutable and unaffected by this method.

Parameters:: moneyToSubtract - the monetary value to subtract, not null
Returns:: the new instance with the input amount subtracted, never null
Throws:: CurrencyMismatchException - if the currencies differ

minus

public Money minus(BigDecimal amountToSubtract)

Returns a copy of this monetary value with the amount subtracted.

This subtracts the specified amount from this monetary amount, returning a new object. No rounding is performed on the amount to be subtracted, so it must have a scale compatible with the currency.

This instance is immutable and unaffected by this method.

Parameters:: amountToSubtract - the monetary value to subtract, not null
Returns:: the new instance with the input amount subtracted, never null
Throws:: ArithmeticException - if the scale of the amount is too large

minus

public Money minus(BigDecimal amountToSubtract,
                   RoundingMode roundingMode)

Returns a copy of this monetary value with the amount subtracted.

This subtracts the specified amount from this monetary amount, returning a new object. If the amount to subtract exceeds the scale of the currency, then the rounding mode will be used to adjust the result.

This instance is immutable and unaffected by this method.

Parameters:: amountToSubtract - the monetary value to subtract, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance with the input amount subtracted, never null

minus

public Money minus(double amountToSubtract)

Returns a copy of this monetary value with the amount subtracted.

This subtracts the specified amount from this monetary amount, returning a new object. No rounding is performed on the amount to be subtracted, so it must have a scale compatible with the currency.

This instance is immutable and unaffected by this method.

Parameters:: amountToSubtract - the monetary value to subtract, not null
Returns:: the new instance with the input amount subtracted, never null
Throws:: ArithmeticException - if the scale of the amount is too large

minus

public Money minus(double amountToSubtract,
                   RoundingMode roundingMode)

Returns a copy of this monetary value with the amount subtracted.

This instance is immutable and unaffected by this method.

Parameters:: amountToSubtract - the monetary value to subtract, not null; roundingMode - the rounding mode to use, not null
Returns:: the new instance with the input amount subtracted, never null

minusMajor

public Money minusMajor(long amountToSubtract)

Returns a copy of this monetary value with the amount in major units subtracted.

This subtracts an amount in major units, leaving the minor units untouched. For example, USD 23.45 minus 138 gives USD -114.55.

This instance is immutable and unaffected by this method.

Parameters:: amountToSubtract - the monetary value to subtract, not null
Returns:: the new instance with the input amount subtracted, never null

minusMinor

public Money minusMinor(long amountToSubtract)

Returns a copy of this monetary value with the amount in minor units subtracted.

This subtracts an amount in minor units. For example, USD 23.45 minus 138 gives USD 22.07.

This instance is immutable and unaffected by this method.

Parameters:: amountToSubtract - the monetary value to subtract, not null
Returns:: the new instance with the input amount subtracted, never null

multipliedBy

public Money multipliedBy(BigDecimal valueToMultiplyBy,
                          RoundingMode roundingMode)

Returns a copy of this monetary value multiplied by the specified value.

This takes this amount and multiplies it by the specified value, rounding the result is rounded as specified.

This instance is immutable and unaffected by this method.

Parameters:: valueToMultiplyBy - the scalar value to multiply by, not null; roundingMode - the rounding mode to use to bring the decimal places back in line, not null
Returns:: the new multiplied instance, never null
Throws:: ArithmeticException - if the rounding fails

multipliedBy

public Money multipliedBy(double valueToMultiplyBy,
                          RoundingMode roundingMode)

Returns a copy of this monetary value multiplied by the specified value.

This takes this amount and multiplies it by the specified value, rounding the result is rounded as specified.

This instance is immutable and unaffected by this method.

Parameters:: valueToMultiplyBy - the scalar value to multiply by, not null; roundingMode - the rounding mode to use to bring the decimal places back in line, not null
Returns:: the new multiplied instance, never null
Throws:: ArithmeticException - if the rounding fails

multipliedBy

public Money multipliedBy(long valueToMultiplyBy)

Returns a copy of this monetary value multiplied by the specified value.

This takes this amount and multiplies it by the specified value.

This instance is immutable and unaffected by this method.

Parameters:: valueToMultiplyBy - the scalar value to multiply by, not null
Returns:: the new multiplied instance, never null

dividedBy

public Money dividedBy(BigDecimal valueToDivideBy,
                       RoundingMode roundingMode)

Returns a copy of this monetary value divided by the specified value.

This takes this amount and divides it by the specified value, rounding the result is rounded as specified.

This instance is immutable and unaffected by this method.

Parameters:: valueToDivideBy - the scalar value to divide by, not null; roundingMode - the rounding mode to use, not null
Returns:: the new divided instance, never null
Throws:: ArithmeticException - if dividing by zero; ArithmeticException - if the rounding fails

dividedBy

public Money dividedBy(double valueToDivideBy,
                       RoundingMode roundingMode)

Returns a copy of this monetary value divided by the specified value.

This takes this amount and divides it by the specified value, rounding the result is rounded as specified.

This instance is immutable and unaffected by this method.

Parameters:: valueToDivideBy - the scalar value to divide by, not null; roundingMode - the rounding mode to use, not null
Returns:: the new divided instance, never null
Throws:: ArithmeticException - if dividing by zero; ArithmeticException - if the rounding fails

dividedBy

public Money dividedBy(long valueToDivideBy,
                       RoundingMode roundingMode)

Returns a copy of this monetary value divided by the specified value.

This takes this amount and divides it by the specified value, rounding the result is rounded as specified.

This instance is immutable and unaffected by this method.

Parameters:: valueToDivideBy - the scalar value to divide by, not null; roundingMode - the rounding mode to use, not null
Returns:: the new divided instance, never null
Throws:: ArithmeticException - if dividing by zero; ArithmeticException - if the rounding fails

negated

public Money negated()

Returns a copy of this monetary value with the amount negated.

This instance is immutable and unaffected by this method.

Returns:: the new instance with the amount negated, never null

abs

public Money abs()

Returns a copy of this monetary value with a positive amount.

This instance is immutable and unaffected by this method.

Returns:: the new instance with the amount converted to be positive, never null

rounded

public Money rounded(int scale,
                     RoundingMode roundingMode)

Returns a copy of this monetary value rounded to the specified scale without changing the current scale.

Scale has the same meaning as in BigDecimal. A scale of 2 means round to 2 decimal places.

Rounding 'EUR 45.23' to a scale of -1 returns 40.00 or 50.00 depending on the rounding mode.
Rounding 'EUR 45.23' to a scale of 0 returns 45.00 or 46.00 depending on the rounding mode.
Rounding 'EUR 45.23' to a scale of 1 returns 45.20 or 45.30 depending on the rounding mode.
Rounding 'EUR 45.23' to a scale of 2 has no effect (it already has that scale).
Rounding 'EUR 45.23' to a scale of 3 has no effect (the scale is not increased).

This instance is immutable and unaffected by this method.

Parameters:: scale - the new scale; roundingMode - the rounding mode to use, not null
Returns:: the new instance with the amount converted to be positive, never null
Throws:: ArithmeticException - if the rounding fails

convertedTo

public Money convertedTo(CurrencyUnit currency,
                         BigDecimal conversionMultipler,
                         RoundingMode roundingMode)

Returns a copy of this monetary value converted into another currency using the specified conversion rate, with a rounding mode used to adjust the decimal places in the result.

This instance is immutable and unaffected by this method.

Parameters:: currency - the new currency, not null; conversionMultipler - the conversion factor between the currencies, not null; roundingMode - the rounding mode to use to bring the decimal places back in line, not null
Returns:: the new multiplied instance, never null
Throws:: IllegalArgumentException - if the currency is the same as this currency; IllegalArgumentException - if the conversion multiplier is negative; ArithmeticException - if the rounding fails

toBigMoney

public BigMoney toBigMoney()

Implements the BigMoneyProvider interface, returning a BigMoney instance with the same currency, amount and scale.

Specified by:: toBigMoney in interface BigMoneyProvider

Returns:: the money instance, never null

isSameCurrency

public boolean isSameCurrency(BigMoneyProvider other)

Checks if this instance and the specified instance have the same currency.

Parameters:: other - the money to check, not null
Returns:: true if they have the same currency

compareTo

public int compareTo(BigMoneyProvider other)

Compares this monetary value to another.

This allows Money to be compared to any BigMoneyProvider. Scale is ignored in the comparison. The compared values must be in the same currency.

Specified by:: compareTo in interface Comparable<BigMoneyProvider>

Parameters:: other - the other monetary value, not null
Returns:: -1 if this is less than , 0 if equal, 1 if greater than
Throws:: CurrencyMismatchException - if the currencies differ

isEqual

public boolean isEqual(BigMoneyProvider other)

Checks if this monetary value is equal to another.

This allows Money to be compared to any BigMoneyProvider. Scale is ignored, so 'USD 30.00' and 'USD 30' are equal. The compared values must be in the same currency.

Parameters:: other - the other monetary value, not null
Returns:: true is this is greater than the specified monetary value
Throws:: CurrencyMismatchException - if the currencies differ
See Also:: equals(Object)

isGreaterThan

public boolean isGreaterThan(BigMoneyProvider other)

Checks if this monetary value is greater than another.

This allows Money to be compared to any BigMoneyProvider. Scale is ignored in the comparison. The compared values must be in the same currency.

Parameters:: other - the other monetary value, not null
Returns:: true is this is greater than the specified monetary value
Throws:: CurrencyMismatchException - if the currencies differ

isLessThan

public boolean isLessThan(BigMoneyProvider other)

Checks if this monetary value is less than another.

This allows Money to be compared to any BigMoneyProvider. Scale is ignored in the comparison. The compared values must be in the same currency.

Parameters:: other - the other monetary value, not null
Returns:: true is this is less than the specified monetary value
Throws:: CurrencyMismatchException - if the currencies differ

equals

public boolean equals(Object other)

Checks if this monetary value equals another.

The comparison takes into account the scale. The compared values must be in the same currency.

Overrides:: equals in class Object

Parameters:: other - the other object to compare to, not null
Returns:: true if this instance equals the other instance

hashCode

public int hashCode()

Returns a hash code for this monetary value.

Overrides:: hashCode in class Object

Returns:: a suitable hash code

toString

public String toString()

Gets the monetary value as a string.

The format is the 3 letter ISO currency code, followed by a space, followed by the amount as per BigDecimal.toPlainString().

Overrides:: toString in class Object

Returns:: the string representation of this monetary value, never null

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.joda.money Class Money

of

of

of

of

ofMajor

ofMinor

zero

of

of

total

total

total

total

parse

nonNull

getCurrencyUnit

withCurrencyUnit

withCurrencyUnit

getScale

getAmount

getAmountMajor

getAmountMajorLong

getAmountMajorInt

getAmountMinor

getAmountMinorLong

getAmountMinorInt

getMinorPart

isZero

isPositive

isPositiveOrZero

isNegative

isNegativeOrZero

withAmount

withAmount

withAmount

withAmount

plus

plus

plus

plus

plus

plus

plusMajor

plusMinor

minus

minus

minus

minus

minus

minus

minusMajor

minusMinor

multipliedBy

multipliedBy

multipliedBy

dividedBy

dividedBy

dividedBy

negated

abs

rounded

convertedTo

toBigMoney

isSameCurrency

compareTo

isEqual

isGreaterThan

isLessThan

equals

hashCode

toString

org.joda.money
Class Money