Added in API level 30

CurrencyPrecision


public abstract class CurrencyPrecision
extends Precision

java.lang.Object
   ↳ android.icu.number.Precision
     ↳ android.icu.number.CurrencyPrecision


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.

See also:

Summary

Public methods

Precision withCurrency(Currency currency)

Associates a currency with this rounding strategy.

Inherited methods

Public methods

withCurrency

Added in API level 30
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.

Throws
IllegalArgumentException for null Currency

See also: