public abstract Class CurrencyPrecision

Class Inheritance

extends Precision

java.lang.Object
com.ibm.icu.number.Precision
com.ibm.icu.number.CurrencyPrecision

Known Direct Subclasses

com.ibm.icu.number.Precision.CurrencyRounderImpl

Imports

com.ibm.icu.util.Currency

A class that defines a rounding strategy parameterized by a currency to be used when formatting numbers in NumberFormatter.

To create a CurrencyPrecision, use one of the factory methods on Precision.

ICU Status: Stable since ICU 60.
See Also: NumberFormatter

Field Summary

Inherited from com.ibm.icu.number.Precision:: BOGUS_PRECISION COMPACT_STRATEGY DEFAULT_MAX_FRAC_6 FIXED_FRAC_0 FIXED_FRAC_2 FIXED_SIG_2 FIXED_SIG_3 mathContext MONETARY_CASH MONETARY_STANDARD NICKEL NONE RANGE_SIG_2_3 trailingZeroDisplay

Constructor Summary

Access	Constructor and Description
pack-priv	CurrencyPrecision()

Method Summary

Modifier and Type	Method and Description
public Precision	Returns: A Precision for chaining or passing to the NumberFormatter rounding() setter. withCurrency(Currency The currency to associate with this rounding strategy. currency) Associates a currency with this rounding strategy.

Constructor Detail

CurrencyPrecision	back to summary
pack-priv CurrencyPrecision()

Method Detail

withCurrency back to summary

withCurrency	back to summary
public Precision withCurrency(Currency currency) Associates a currency with this rounding strategy. Calling this method is not required, because the currency specified in unit() or via a CurrencyAmount passed into format(Measure) is automatically applied to currency rounding strategies. However, this method enables you to override that automatic association. This method also enables numbers to be formatted using currency rounding rules without explicitly using a currency format. Parameters currency:Currency The currency to associate with this rounding strategy. Returns:Precision A Precision for chaining or passing to the NumberFormatter rounding() setter. Exceptions IllegalArgumentException: for null Currency ICU Status Stable since ICU 60. See Also `NumberFormatter`

public Precision withCurrency(Currency currency)

Associates a currency with this rounding strategy.

Calling this method is not required, because the currency specified in unit() or via a CurrencyAmount passed into format(Measure) is automatically applied to currency rounding strategies. However, this method enables you to override that automatic association.

This method also enables numbers to be formatted using currency rounding rules without explicitly using a currency format.

Parameters

currency:Currency: The currency to associate with this rounding strategy.

Returns:Precision

A Precision for chaining or passing to the NumberFormatter rounding() setter.

Exceptions

IllegalArgumentException:: for null Currency

ICU Status

Stable since ICU 60.

See Also

NumberFormatter