Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Constants](https://developer.android.com/reference/android/icu/text/DecimalFormat#constants) \| [Inherited Constants](https://developer.android.com/reference/android/icu/text/DecimalFormat#inhconstants) \| [Ctors](https://developer.android.com/reference/android/icu/text/DecimalFormat#pubctors) \| [Methods](https://developer.android.com/reference/android/icu/text/DecimalFormat#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/icu/text/DecimalFormat#inhmethods)
# DecimalFormat
*** ** * ** ***
`
public
class
DecimalFormat
`
`
`
`
`
`
`
`
extends https://developer.android.com/reference/android/icu/text/NumberFormat
`
`
`
|---|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.text.Format](https://developer.android.com/reference/java/text/Format) ||||
| | ↳ | [android.icu.text.UFormat](https://developer.android.com/reference/android/icu/text/UFormat) |||
| | | ↳ | [android.icu.text.NumberFormat](https://developer.android.com/reference/android/icu/text/NumberFormat) ||
| | | | ↳ | android.icu.text.DecimalFormat |
|---|
| Known direct subclasses [CompactDecimalFormat](https://developer.android.com/reference/android/icu/text/CompactDecimalFormat) |---|---| | [CompactDecimalFormat](https://developer.android.com/reference/android/icu/text/CompactDecimalFormat) | Formats numbers in compact (abbreviated) notation, like "1.2K" instead of "1200". | |
*** ** * ** ***
**\[icu enhancement\]** ICU's replacement for `https://developer.android.com/reference/java/text/DecimalFormat`. Methods, fields, and other functionality specific to ICU are labeled '**\[icu\]**'.
**IMPORTANT:** New users are strongly encouraged to see if
`https://developer.android.com/reference/android/icu/number/NumberFormatter` fits their use case. Although not deprecated, this
class, DecimalFormat, is only provided for java.text.DecimalFormat compatibility.
*** ** * ** ***
`DecimalFormat` is the primary concrete subclass of `https://developer.android.com/reference/android/icu/text/NumberFormat`. It has a variety of features designed to make it possible to parse and format numbers in any locale, including support for Western, Arabic, or Indic digits. It supports different flavors of numbers, including integers ("123"), fixed-point numbers ("123.4"), scientific notation ("1.23E4"), percentages ("12%"), and currency amounts ("$123.00", "USD123.00", "123.00 US dollars"). All of these flavors can be easily localized.
To obtain a number formatter for a specific locale (including the default locale), call one of
NumberFormat's factory methods such as `https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance()`. Do not call
DecimalFormat constructors directly unless you know what you are doing.
DecimalFormat aims to comply with the specification [UTS #35](http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns). Read
the specification for more information on how all the properties in DecimalFormat fit together.
**NOTE:** Starting in ICU 60, there is a new set of APIs for localized number
formatting that are designed to be an improvement over DecimalFormat. New users are discouraged
from using DecimalFormat. For more information, see the package android.icu.number.
### Example Usage
Customize settings on a DecimalFormat instance from the NumberFormat factory:
> ```
> NumberFormat f = NumberFormat.getInstance(loc);
> if (f instanceof DecimalFormat) {
> ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true);
> ((DecimalFormat) f).setMinimumGroupingDigits(2);
> }
> ```
Quick and dirty print out a number using the localized number, currency, and percent format
for each locale:
> ```
> for (ULocale uloc : ULocale.getAvailableLocales()) {
> System.out.print(uloc + ":\t");
> System.out.print(NumberFormat.getInstance(uloc).format(1.23));
> System.out.print("\t");
> System.out.print(NumberFormat.getCurrencyInstance(uloc).format(1.23));
> System.out.print("\t");
> System.out.print(NumberFormat.getPercentInstance(uloc).format(1.23));
> System.out.println();
> }
> ```
### Properties and Symbols
A DecimalFormat object encapsulates a set of *properties* and a set of
*symbols*. Grouping size, rounding mode, and affixes are examples of properties. Locale
digits and the characters used for grouping and decimal separators are examples of symbols.
To set a custom set of symbols, use `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalFormatSymbols(android.icu.text.DecimalFormatSymbols)`. Use the various other
setters in this class to set custom values for the properties.
### Rounding
DecimalFormat provides three main strategies to specify the position at which numbers should
be rounded:
1. **Magnitude:** Display a fixed number of fraction digits; this is the most common form.
2. **Increment:** Round numbers to the closest multiple of a certain increment, such as 0.05. This is common in currencies.
3. **Significant Digits:** Round numbers such that a fixed number of nonzero digits are shown. This is most common in scientific notation.
It is not possible to specify more than one rounding strategy. For example, setting a rounding
increment in conjunction with significant digits results in undefined behavior.
It is also possible to specify the *rounding mode* to use. The default rounding mode is
"half even", which rounds numbers to their closest increment, with ties broken in favor of
trailing numbers being even. For more information, see `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)` and [the ICU
User Guide](https://unicode-org.github.io/icu/userguide/format_parse/numbers/rounding-modes).
### Pattern Strings
A *pattern string* is a way to serialize some of the available properties for decimal
formatting. However, not all properties are capable of being serialized into a pattern string;
see `https://developer.android.com/reference/android/icu/text/DecimalFormat#applyPattern(java.lang.String)` for more information.
Most users should not need to interface with pattern strings directly.
ICU DecimalFormat aims to follow the specification for pattern strings in [UTS #35](http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns).
Refer to that specification for more information on pattern string syntax.
#### Pattern String BNF
The following BNF is used when parsing the pattern string into property values:
```
pattern := subpattern (';' subpattern)?
subpattern := prefix? number exponent? suffix?
number := (integer ('.' fraction)?) | sigDigits
prefix := '\u0000'..'\uFFFD' - specialCharacters
suffix := '\u0000'..'\uFFFD' - specialCharacters
integer := '#'* '0'* '0'
fraction := '0'* '#'*
sigDigits := '#'* '@' '@'* '#'*
exponent := 'E' '+'? '0'* '0'
padSpec := '*' padChar
padChar := '\u0000'..'\uFFFD' - quote
Notation:
X* 0 or more instances of X
X? 0 or 1 instances of X
X|Y either X or Y
C..D any character from C up to D, inclusive
S-T characters in S, except those in T
```
The first subpattern is for positive numbers. The second (optional) subpattern is for negative
numbers.
Not indicated in the BNF syntax above:
- The grouping separator ',' can occur inside the integer and sigDigits elements, between any two pattern characters of that element, as long as the integer or sigDigits element is not followed by the exponent element.
- Two grouping intervals are recognized: That between the decimal point and the first grouping symbol, and that between the first and second grouping symbols. These intervals are identical in most locales, but in some locales they differ. For example, the pattern "#,##,###" formats the number 123456789 as "12,34,56,789".
- The pad specifier `padSpec` may appear before the prefix, after the prefix, before the suffix, after the suffix, or not at all.
- In place of '0', the digits '1' through '9' may be used to indicate a rounding increment.
### Parsing
DecimalFormat aims to be able to parse anything that it can output as a formatted string.
There are two primary parse modes: *lenient* and *strict* . Lenient mode should
be used if the goal is to parse user input to a number; strict mode should be used if the goal is
validation. The default is lenient mode. For more information, see `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseStrict(boolean)`.
`DecimalFormat` parses all Unicode characters that represent decimal digits, as
defined by `https://developer.android.com/reference/android/icu/lang/UCharacter#digit(int)`. In addition, `DecimalFormat` also recognizes as
digits the ten consecutive characters starting with the localized zero digit defined in the
`https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols` object. During formatting, the `https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols`-based
digits are output.
Grouping separators are ignored in lenient mode (default). In strict mode, grouping separators
must match the locale-specified grouping sizes.
When using `https://developer.android.com/reference/android/icu/text/DecimalFormat#parseCurrency(java.lang.CharSequence,%20java.text.ParsePosition)`, all currencies are accepted, not just the currency
currently set in the formatter. In addition, the formatter is able to parse every currency style
format for a particular locale no matter which style the formatter is constructed with. For
example, a formatter instance gotten from NumberFormat.getInstance(ULocale,
NumberFormat.CURRENCYSTYLE) can parse both "USD1.00" and "3.00 US dollars".
Whitespace characters (lenient mode) and control characters (lenient and strict mode),
collectively called "ignorables", do not need to match in identity or quantity between the
pattern string and the input string. For example, the pattern "# %" matches "35 %" (with a single
space), "35%" (with no space), "35 %" (with a non-breaking space), and "35 %" (with
multiple spaces). Arbitrary ignorables are also allowed at boundaries between the parts of the
number: prefix, number, exponent separator, and suffix. Ignorable whitespace characters are those
having the Unicode "blank" property for regular expressions, defined in UTS #18 Annex C, which is
"horizontal" whitespace, like spaces and tabs, but not "vertical" whitespace, like line breaks.
Ignorable control characters are those in the Unicode set \[:Default_Ignorable_Code_Point:\].
If `https://developer.android.com/reference/android/icu/text/DecimalFormat#parse(java.lang.String,%20java.text.ParsePosition)` fails to parse a string, it returns `null`
and leaves the parse position unchanged. The convenience method `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` indicates
parse failure by throwing a `https://developer.android.com/reference/java/text/ParseException`.
Under the hood, a state table parsing engine is used. To debug a parsing failure during
development, use the following pattern to print details about the state table transitions:
```
android.icu.impl.number.Parse.DEBUGGING = true;
df.parse("123.45", ppos);
android.icu.impl.number.Parse.DEBUGGING = false;
```
### Thread Safety and Best Practices
Starting with ICU 59, instances of DecimalFormat are thread-safe.
Under the hood, DecimalFormat maintains an immutable formatter object that is rebuilt whenever
any of the property setters are called. It is therefore best practice to call property setters
only during construction and not when formatting numbers online.
**See also:**
- `https://developer.android.com/reference/java/text/Format`
- `https://developer.android.com/reference/android/icu/text/NumberFormat`
## Summary
| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/icu/text/DecimalFormat#MINIMUM_GROUPING_DIGITS_AUTO` **\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)` to specify display grouping using the default strategy for all locales. |
| `int` | `https://developer.android.com/reference/android/icu/text/DecimalFormat#MINIMUM_GROUPING_DIGITS_MIN2` **\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)` to specify display grouping using locale defaults, except do not show grouping on values smaller than 10000 (such that there is a minimum of two digits before the first separator). |
| `int` | `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_PREFIX` **\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad characters inserted after the prefix. |
| `int` | `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_SUFFIX` **\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad characters inserted after the suffix. |
| `int` | `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_PREFIX` **\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad characters inserted before the prefix. |
| `int` | `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_SUFFIX` **\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad characters inserted before the suffix. |
| ### Inherited constants |
|---|
| From class `https://developer.android.com/reference/android/icu/text/NumberFormat` |---|---| | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#ACCOUNTINGCURRENCYSTYLE` **\[icu\]** Constant to specify currency style of format which uses currency symbol to represent currency for accounting, for example: "($3.00), instead of "-$3.00" (`https://developer.android.com/reference/android/icu/text/NumberFormat#CURRENCYSTYLE`). | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#CASHCURRENCYSTYLE` **\[icu\]** Constant to specify currency cash style of format which uses currency ISO code to represent currency, for example: "NT$3" instead of "NT$3.23". | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#CURRENCYSTYLE` **\[icu\]** Constant to specify general currency style of format. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#FRACTION_FIELD` Field constant used to construct a FieldPosition object. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#INTEGERSTYLE` **\[icu\]** Constant to specify a integer number style format. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#INTEGER_FIELD` Field constant used to construct a FieldPosition object. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#ISOCURRENCYSTYLE` **\[icu\]** Constant to specify currency style of format which uses currency ISO code to represent currency, for example: "USD3.00". | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#NUMBERSTYLE` **\[icu\]** Constant to specify normal number style of format. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#PERCENTSTYLE` **\[icu\]** Constant to specify a style of format to display percent. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#PLURALCURRENCYSTYLE` **\[icu\]** Constant to specify currency style of format which uses currency long name with plural format to represent currency, for example, "3.00 US Dollars". | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#SCIENTIFICSTYLE` **\[icu\]** Constant to specify a style of format to display scientific number. | | `int` | `https://developer.android.com/reference/android/icu/text/NumberFormat#STANDARDCURRENCYSTYLE` **\[icu\]** Constant to specify currency style of format which uses currency symbol to represent currency, for example "$3.00", using non-accounting style for negative values (e.g. | |
| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/icu/text/DecimalFormat#DecimalFormat()() ` Creates a DecimalFormat based on the number pattern and symbols for the default locale. |
| ` https://developer.android.com/reference/android/icu/text/DecimalFormat#DecimalFormat(java.lang.String)(https://developer.android.com/reference/java/lang/String pattern) ` Creates a DecimalFormat based on the given pattern, using symbols for the default locale. |
| ` https://developer.android.com/reference/android/icu/text/DecimalFormat#DecimalFormat(java.lang.String,%20android.icu.text.DecimalFormatSymbols)(https://developer.android.com/reference/java/lang/String pattern, https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols symbols) ` Creates a DecimalFormat based on the given pattern and symbols. |
| ` https://developer.android.com/reference/android/icu/text/DecimalFormat#DecimalFormat(java.lang.String,%20android.icu.text.DecimalFormatSymbols,%20android.icu.text.CurrencyPluralInfo,%20int)(https://developer.android.com/reference/java/lang/String pattern, https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols symbols, https://developer.android.com/reference/android/icu/text/CurrencyPluralInfo infoInput, int style) ` Creates a DecimalFormat based on the given pattern and symbols, with additional control over the behavior of currency. |
| ### Public methods ||
|---|---|
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#applyLocalizedPattern(java.lang.String)(https://developer.android.com/reference/java/lang/String localizedPattern) ` Converts the given string to standard notation and then parses it using `https://developer.android.com/reference/android/icu/text/DecimalFormat#applyPattern(java.lang.String)`. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#applyPattern(java.lang.String)(https://developer.android.com/reference/java/lang/String pattern) ` Parses the given pattern string and overwrites the settings specified in the pattern string. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#areSignificantDigitsUsed()() ` **\[icu\]** Returns whether significant digits are being used in rounding. |
| ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#clone()() ` Overrides clone. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Tests for equality between this formatter and another formatter. |
| ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#format(java.math.BigInteger,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/java/math/BigInteger number, https://developer.android.com/reference/java/lang/StringBuffer result, https://developer.android.com/reference/java/text/FieldPosition fieldPosition) ` **\[icu\]** Formats a BigInteger. |
| ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#format(android.icu.util.CurrencyAmount,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/android/icu/util/CurrencyAmount currAmt, https://developer.android.com/reference/java/lang/StringBuffer result, https://developer.android.com/reference/java/text/FieldPosition fieldPosition) ` **\[icu\]** Formats a CurrencyAmount. |
| ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#format(android.icu.math.BigDecimal,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/android/icu/math/BigDecimal number, https://developer.android.com/reference/java/lang/StringBuffer result, https://developer.android.com/reference/java/text/FieldPosition fieldPosition) ` **\[icu\]** Formats an ICU BigDecimal. |
| ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#format(double,%20java.lang.StringBuffer,%20java.text.FieldPosition)(double number, https://developer.android.com/reference/java/lang/StringBuffer result, https://developer.android.com/reference/java/text/FieldPosition fieldPosition) ` Specialization of format. |
| ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#format(java.math.BigDecimal,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/java/math/BigDecimal number, https://developer.android.com/reference/java/lang/StringBuffer result, https://developer.android.com/reference/java/text/FieldPosition fieldPosition) ` **\[icu\]** Formats a BigDecimal. |
| ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#format(long,%20java.lang.StringBuffer,%20java.text.FieldPosition)(long number, https://developer.android.com/reference/java/lang/StringBuffer result, https://developer.android.com/reference/java/text/FieldPosition fieldPosition) ` Specialization of format. |
| ` https://developer.android.com/reference/java/text/AttributedCharacterIterator` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#formatToCharacterIterator(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Formats an Object producing an `AttributedCharacterIterator`. |
| ` https://developer.android.com/reference/android/icu/util/Currency` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getCurrency()() ` Returns the currency used to display currency amounts. |
| ` https://developer.android.com/reference/android/icu/text/CurrencyPluralInfo` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getCurrencyPluralInfo()() ` **\[icu\]** Returns the current instance of CurrencyPluralInfo. |
| ` https://developer.android.com/reference/android/icu/util/Currency.CurrencyUsage` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getCurrencyUsage()() ` **\[icu\]** Returns the strategy for rounding currency amounts. |
| ` https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getDecimalFormatSymbols()() ` Returns a copy of the decimal format symbols used by this formatter. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getFormatWidth()() ` Returns the minimum number of characters in formatted output. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getGroupingSize()() ` Returns the primary grouping size in use. |
| ` https://developer.android.com/reference/java/math/MathContext` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMathContext()() ` **\[icu\]** Returns the `https://developer.android.com/reference/java/math/MathContext` being used to round numbers. |
| ` https://developer.android.com/reference/android/icu/math/MathContext` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMathContextICU()() ` **\[icu\]** Returns the `https://developer.android.com/reference/android/icu/math/MathContext` being used to round numbers. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMaximumFractionDigits()() ` Returns the effective maximum number of integer digits after the decimal separator. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMaximumIntegerDigits()() ` Returns the effective maximum number of digits before the decimal separator. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMaximumSignificantDigits()() ` **\[icu\]** Returns the effective maximum number of significant digits displayed. |
| ` byte` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMinimumExponentDigits()() ` **\[icu\]** Returns the minimum number of digits printed in the exponent in scientific notation. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMinimumFractionDigits()() ` Returns the effective minimum number of integer digits after the decimal separator. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMinimumGroupingDigits()() ` **\[icu\]** Returns the minimum number of digits before grouping is triggered. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMinimumIntegerDigits()() ` Returns the effective minimum number of digits before the decimal separator. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMinimumSignificantDigits()() ` **\[icu\]** Returns the effective minimum number of significant digits displayed. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getMultiplier()() ` Returns the multiplier being applied to numbers before they are formatted. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getNegativePrefix()() ` **Affixes:** Gets the negative prefix string currently being used to format numbers. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getNegativeSuffix()() ` **Affixes:** Gets the negative suffix string currently being used to format numbers. |
| ` char` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadCharacter()() ` **\[icu\]** Returns the character used for padding. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()() ` **\[icu\]** Returns the position used for padding. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getParseMaxDigits()() ` *This method was deprecated in API level 28. Setting max parse digits has no effect since ICU4J 59.* |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getPositivePrefix()() ` **Affixes:** Gets the positive prefix string currently being used to format numbers. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getPositiveSuffix()() ` **Affixes:** Gets the positive suffix string currently being used to format numbers. |
| ` https://developer.android.com/reference/java/math/BigDecimal` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getRoundingIncrement()() ` **\[icu\]** Returns the increment to which numbers are being rounded. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getRoundingMode()() ` Returns the rounding mode being used to round numbers. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#getSecondaryGroupingSize()() ` **\[icu\]** Returns the secondary grouping size in use. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#hashCode()() ` Returns a hash code value for the object. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isDecimalPatternMatchRequired()() ` **\[icu\]** Returns whether the presence of a decimal point must match the pattern. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isDecimalSeparatorAlwaysShown()() ` Returns whether the decimal separator is shown on integers. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isExponentSignAlwaysShown()() ` **\[icu\]** Returns whether the sign (plus or minus) is always printed in scientific notation. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isGroupingUsed()() ` Returns whether or not grouping separators are being printed in the output. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isParseBigDecimal()() ` Returns whether `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` will always return a BigDecimal. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isParseCaseSensitive()() ` **\[icu\]** Returns whether to force case (uppercase/lowercase) to match when parsing. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isParseIntegerOnly()() ` Returns true if this format will parse numbers as integers only. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isParseNoExponent()() ` **\[icu\]** Returns whether to ignore exponents when parsing. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isParseStrict()() ` **\[icu\]** Returns whether strict parsing is in effect. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isScientificNotation()() ` **\[icu\]** Returns whether scientific (exponential) notation is enabled on this formatter. |
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#isSignAlwaysShown()() ` **\[icu\]** Returns whether the sign is being shown on positive numbers. |
| ` https://developer.android.com/reference/java/lang/Number` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#parse(java.lang.String,%20java.text.ParsePosition)(https://developer.android.com/reference/java/lang/String text, https://developer.android.com/reference/java/text/ParsePosition parsePosition) ` Returns a Long if possible (e.g., within the range \[Long.MIN_VALUE, Long.MAX_VALUE\] and with no decimals); otherwise, returns another type, such as a BigDecimal, BigInteger, or Double. |
| ` https://developer.android.com/reference/android/icu/util/CurrencyAmount` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#parseCurrency(java.lang.CharSequence,%20java.text.ParsePosition)(https://developer.android.com/reference/java/lang/CharSequence text, https://developer.android.com/reference/java/text/ParsePosition parsePosition) ` Parses text from the given string as a CurrencyAmount. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrency(android.icu.util.Currency)(https://developer.android.com/reference/android/icu/util/Currency currency) ` Sets the currency to be used when formatting numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrencyPluralInfo(android.icu.text.CurrencyPluralInfo)(https://developer.android.com/reference/android/icu/text/CurrencyPluralInfo newInfo) ` **\[icu\]** Sets a custom instance of CurrencyPluralInfo. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrencyUsage(android.icu.util.Currency.CurrencyUsage)(https://developer.android.com/reference/android/icu/util/Currency.CurrencyUsage usage) ` **\[icu\]** Sets the currency-dependent strategy to use when rounding numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalFormatSymbols(android.icu.text.DecimalFormatSymbols)(https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols newSymbols) ` Sets the decimal format symbols used by this formatter. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalPatternMatchRequired(boolean)(boolean value) ` **\[icu\]** **Parsing:** This method is used to either *require* or *forbid* the presence of a decimal point in the string being parsed (disabled by default). |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalSeparatorAlwaysShown(boolean)(boolean value) ` **Separators:** Sets whether the decimal separator (a period in *en-US*) is shown on integers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setExponentSignAlwaysShown(boolean)(boolean expSignAlways) ` **\[icu\]** **Scientific Notation:** Sets whether the sign (plus or minus) is always to be shown in the exponent in scientific notation. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)(int width) ` **Padding:** Sets the minimum width of the string output by the formatting pipeline. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingSize(int)(int width) ` **Grouping:** Sets the primary grouping size (distance between grouping separators) used when formatting large numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingUsed(boolean)(boolean enabled) ` **Grouping:** Sets whether grouping is to be used when formatting numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContext(java.math.MathContext)(https://developer.android.com/reference/java/math/MathContext mathContext) ` **\[icu\]** **Rounding and Digit Limits:** Sets the `https://developer.android.com/reference/java/math/MathContext` used to round numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContextICU(android.icu.math.MathContext)(https://developer.android.com/reference/android/icu/math/MathContext mathContextICU) ` **\[icu\]** **Rounding and Digit Limits:** Overload of `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContext(java.math.MathContext)` for `https://developer.android.com/reference/android/icu/math/MathContext`. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)(int value) ` **Rounding and Digit Limits:** Sets the maximum number of digits to display after the decimal separator. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumIntegerDigits(int)(int value) ` **Rounding and Digit Limits:** Sets the maximum number of digits to display before the decimal separator. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)(int value) ` **\[icu\]** **Rounding and Digit Limits:** Sets the maximum number of significant digits to be displayed. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumExponentDigits(byte)(byte minExpDig) ` **\[icu\]** **Scientific Notation:** Sets the minimum number of digits to be printed in the exponent. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumFractionDigits(int)(int value) ` **Rounding and Digit Limits:** Sets the minimum number of digits to display after the decimal separator. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)(int number) ` **\[icu\]** Sets the minimum number of digits that must be before the first grouping separator in order for the grouping separator to be printed. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumIntegerDigits(int)(int value) ` **Rounding and Digit Limits:** Sets the minimum number of digits to display before the decimal separator. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumSignificantDigits(int)(int value) ` **\[icu\]** **Rounding and Digit Limits:** Sets the minimum number of significant digits to be displayed. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setMultiplier(int)(int multiplier) ` Sets a number that will be used to multiply all numbers prior to formatting. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setNegativePrefix(java.lang.String)(https://developer.android.com/reference/java/lang/String prefix) ` **Affixes:** Sets the string to prepend to negative numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setNegativeSuffix(java.lang.String)(https://developer.android.com/reference/java/lang/String suffix) ` **Affixes:** Sets the string to append to negative numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadCharacter(char)(char padChar) ` **\[icu\]** **Padding:** Sets the character used to pad numbers that are narrower than the width specified in `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)(int padPos) ` **\[icu\]** **Padding:** Sets the position where to insert the pad character when narrower than the width specified in `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseBigDecimal(boolean)(boolean value) ` Whether to make `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` prefer returning a `https://developer.android.com/reference/android/icu/math/BigDecimal` when possible. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseCaseSensitive(boolean)(boolean value) ` **\[icu\]** Specifies whether parsing should require cases to match in affixes, exponent separators, and currency codes. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseIntegerOnly(boolean)(boolean parseIntegerOnly) ` **Parsing:** Sets whether to ignore the fraction part of a number when parsing (defaults to false). This is functionally equivalent to calling `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalPatternMatchRequired(boolean)` and a pattern without a decimal point. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseMaxDigits(int)(int maxDigits) ` *This method was deprecated in API level 28. Setting max parse digits has no effect since ICU4J 59.* |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseNoExponent(boolean)(boolean value) ` **\[icu\]** Specifies whether to stop parsing when an exponent separator is encountered. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseStrict(boolean)(boolean parseStrict) ` **\[icu\]** Sets whether strict parsing is in effect. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setPositivePrefix(java.lang.String)(https://developer.android.com/reference/java/lang/String prefix) ` **Affixes:** Sets the string to prepend to positive numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setPositiveSuffix(java.lang.String)(https://developer.android.com/reference/java/lang/String suffix) ` **Affixes:** Sets the string to append to positive numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(java.math.BigDecimal)(https://developer.android.com/reference/java/math/BigDecimal increment) ` **\[icu\]** **Rounding and Digit Limits:** Sets an increment, or interval, to which numbers are rounded. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)(https://developer.android.com/reference/android/icu/math/BigDecimal increment) ` **\[icu\]** **Rounding and Digit Limits:** Overload of `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(java.math.BigDecimal)`. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(double)(double increment) ` **\[icu\]** **Rounding and Digit Limits:** Overload of `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(java.math.BigDecimal)`. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)(int roundingMode) ` **Rounding and Digit Limits:** Sets the `https://developer.android.com/reference/java/math/RoundingMode` used to round numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setScientificNotation(boolean)(boolean useScientific) ` **\[icu\]** **Scientific Notation:** Sets whether this formatter should print in scientific (exponential) notation. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setSecondaryGroupingSize(int)(int width) ` **\[icu\]** **Grouping:** Sets the secondary grouping size (distance between grouping separators after the first separator) used when formatting large numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setSignAlwaysShown(boolean)(boolean value) ` Sets whether to always shown the plus sign ('+' in *en*) on positive numbers. |
| ` void` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#setSignificantDigitsUsed(boolean)(boolean useSignificantDigits) ` **\[icu\]** **Rounding and Digit Limits:** Sets whether significant digits are to be used in rounding. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#toLocalizedPattern()() ` Calls `https://developer.android.com/reference/android/icu/text/DecimalFormat#toPattern()` and converts the string to localized notation. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#toPattern()() ` Serializes this formatter object to a decimal format pattern string. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/DecimalFormat#toString()() ` Returns the default value of toString() with extra DecimalFormat-specific information appended to the end of the string. |
| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/android/icu/text/NumberFormat ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#clone()() ` Overrides clone. | | ` boolean` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Overrides equals. | | ` abstract https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(java.math.BigInteger,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/java/math/BigInteger number, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` **\[icu\]** Formats a BigInteger. | | ` abstract https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(android.icu.math.BigDecimal,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/android/icu/math/BigDecimal number, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` **\[icu\]** Formats an ICU BigDecimal. | | ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(java.lang.Object,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/java/lang/Object number, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` Formats a number and appends the resulting text to the given string buffer. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(java.math.BigDecimal)(https://developer.android.com/reference/java/math/BigDecimal number) ` Convenience method to format a BigDecimal. | | ` abstract https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(double,%20java.lang.StringBuffer,%20java.text.FieldPosition)(double number, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` Specialization of format. | | ` abstract https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(java.math.BigDecimal,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/java/math/BigDecimal number, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` **\[icu\]** Formats a BigDecimal. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(java.math.BigInteger)(https://developer.android.com/reference/java/math/BigInteger number) ` **\[icu\]** Convenience method to format a BigInteger. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(android.icu.math.BigDecimal)(https://developer.android.com/reference/android/icu/math/BigDecimal number) ` **\[icu\]** Convenience method to format an ICU BigDecimal. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(double)(double number) ` Specialization of format. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(long)(long number) ` Specialization of format. | | ` https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(android.icu.util.CurrencyAmount,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/android/icu/util/CurrencyAmount currAmt, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` **\[icu\]** Formats a CurrencyAmount. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(android.icu.util.CurrencyAmount)(https://developer.android.com/reference/android/icu/util/CurrencyAmount currAmt) ` **\[icu\]** Convenience method to format a CurrencyAmount. | | ` abstract https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#format(long,%20java.lang.StringBuffer,%20java.text.FieldPosition)(long number, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` Specialization of format. | | ` static https://developer.android.com/reference/java/util/Locale` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getAvailableLocales()() ` Returns the list of Locales for which NumberFormats are available. | | ` https://developer.android.com/reference/android/icu/text/DisplayContext` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getContext(android.icu.text.DisplayContext.Type)(https://developer.android.com/reference/android/icu/text/DisplayContext.Type type) ` **\[icu\]** Get the formatter's DisplayContext value for the specified DisplayContext.Type, such as CAPITALIZATION. | | ` https://developer.android.com/reference/android/icu/util/Currency` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrency()() ` Returns the `Currency` object used to display currency amounts. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance(java.util.Locale)(https://developer.android.com/reference/java/util/Locale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance(android.icu.util.ULocale)(https://developer.android.com/reference/android/icu/util/ULocale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance()() ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance()() ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance(java.util.Locale)(https://developer.android.com/reference/java/util/Locale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance(android.icu.util.ULocale,%20int)(https://developer.android.com/reference/android/icu/util/ULocale desiredLocale, int choice) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance(java.util.Locale,%20int)(https://developer.android.com/reference/java/util/Locale inLocale, int style) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance(android.icu.util.ULocale)(https://developer.android.com/reference/android/icu/util/ULocale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance(int)(int style) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getIntegerInstance(android.icu.util.ULocale)(https://developer.android.com/reference/android/icu/util/ULocale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getIntegerInstance()() ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getIntegerInstance(java.util.Locale)(https://developer.android.com/reference/java/util/Locale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` int` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getMaximumFractionDigits()() ` Returns the maximum number of digits allowed in the fraction portion of a number. | | ` int` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getMaximumIntegerDigits()() ` Returns the maximum number of digits allowed in the integer portion of a number. | | ` int` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getMinimumFractionDigits()() ` Returns the minimum number of digits allowed in the fraction portion of a number. | | ` int` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getMinimumIntegerDigits()() ` Returns the minimum number of digits allowed in the integer portion of a number. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance(android.icu.util.ULocale)(https://developer.android.com/reference/android/icu/util/ULocale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()() ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance(java.util.Locale)(https://developer.android.com/reference/java/util/Locale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getPattern(android.icu.util.ULocale,%20int)(https://developer.android.com/reference/android/icu/util/ULocale forLocale, int choice) ` Returns the pattern for the provided locale and choice. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getPercentInstance()() ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getPercentInstance(java.util.Locale)(https://developer.android.com/reference/java/util/Locale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getPercentInstance(android.icu.util.ULocale)(https://developer.android.com/reference/android/icu/util/ULocale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` int` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getRoundingMode()() ` Returns the rounding mode used in this NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getScientificInstance(android.icu.util.ULocale)(https://developer.android.com/reference/android/icu/util/ULocale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getScientificInstance(java.util.Locale)(https://developer.android.com/reference/java/util/Locale inLocale) ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` static final https://developer.android.com/reference/android/icu/text/NumberFormat` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#getScientificInstance()() ` **NOTE:** New users are strongly encouraged to use `https://developer.android.com/reference/android/icu/number/NumberFormatter` instead of NumberFormat. | | ` int` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#hashCode()() ` Returns a hash code value for the object. | | ` boolean` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#isGroupingUsed()() ` Returns true if grouping is used in this format. | | ` boolean` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#isParseIntegerOnly()() ` Returns true if this format will parse numbers as integers only. | | ` boolean` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#isParseStrict()() ` **\[icu\]** Returns whether strict parsing is in effect. | | ` https://developer.android.com/reference/java/lang/Number` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)(https://developer.android.com/reference/java/lang/String text) ` Parses text from the beginning of the given string to produce a number. | | ` abstract https://developer.android.com/reference/java/lang/Number` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String,%20java.text.ParsePosition)(https://developer.android.com/reference/java/lang/String text, https://developer.android.com/reference/java/text/ParsePosition parsePosition) ` Returns a Long if possible (e.g., within the range \[Long.MIN_VALUE, Long.MAX_VALUE\] and with no decimals); otherwise, returns another type, such as a BigDecimal, BigInteger, or Double. | | ` https://developer.android.com/reference/android/icu/util/CurrencyAmount` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#parseCurrency(java.lang.CharSequence,%20java.text.ParsePosition)(https://developer.android.com/reference/java/lang/CharSequence text, https://developer.android.com/reference/java/text/ParsePosition pos) ` Parses text from the given string as a CurrencyAmount. | | ` final https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#parseObject(java.lang.String,%20java.text.ParsePosition)(https://developer.android.com/reference/java/lang/String source, https://developer.android.com/reference/java/text/ParsePosition parsePosition) ` Parses text from a string to produce a number. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setContext(android.icu.text.DisplayContext)(https://developer.android.com/reference/android/icu/text/DisplayContext context) ` **\[icu\]** Set a particular DisplayContext value in the formatter, such as CAPITALIZATION_FOR_STANDALONE. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setCurrency(android.icu.util.Currency)(https://developer.android.com/reference/android/icu/util/Currency theCurrency) ` Sets the `Currency` object used to display currency amounts. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setGroupingUsed(boolean)(boolean newValue) ` Sets whether or not grouping will be used in this format. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setMaximumFractionDigits(int)(int newValue) ` Sets the maximum number of digits allowed in the fraction portion of a number. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setMaximumIntegerDigits(int)(int newValue) ` Sets the maximum number of digits allowed in the integer portion of a number. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setMinimumFractionDigits(int)(int newValue) ` Sets the minimum number of digits allowed in the fraction portion of a number. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setMinimumIntegerDigits(int)(int newValue) ` Sets the minimum number of digits allowed in the integer portion of a number. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setParseIntegerOnly(boolean)(boolean value) ` Sets whether to ignore the fraction part of a number when parsing (defaults to false). | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setParseStrict(boolean)(boolean value) ` **\[icu\]** Sets whether strict parsing is in effect. | | ` void` | ` https://developer.android.com/reference/android/icu/text/NumberFormat#setRoundingMode(int)(int roundingMode) ` Set the rounding mode used in this NumberFormat. | ||
| From class ` https://developer.android.com/reference/java/text/Format ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/text/Format#clone()() ` Creates and returns a copy of this object. | | ` final https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/text/Format#format(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Formats an object to produce a string. | | ` abstract https://developer.android.com/reference/java/lang/StringBuffer` | ` https://developer.android.com/reference/java/text/Format#format(java.lang.Object,%20java.lang.StringBuffer,%20java.text.FieldPosition)(https://developer.android.com/reference/java/lang/Object obj, https://developer.android.com/reference/java/lang/StringBuffer toAppendTo, https://developer.android.com/reference/java/text/FieldPosition pos) ` Formats an object and appends the resulting text to a given string buffer. | | ` https://developer.android.com/reference/java/text/AttributedCharacterIterator` | ` https://developer.android.com/reference/java/text/Format#formatToCharacterIterator(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Formats an Object producing an `AttributedCharacterIterator`. | | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/text/Format#parseObject(java.lang.String)(https://developer.android.com/reference/java/lang/String source) ` Parses text from the beginning of the given string to produce an object. | | ` abstract https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/text/Format#parseObject(java.lang.String,%20java.text.ParsePosition)(https://developer.android.com/reference/java/lang/String source, https://developer.android.com/reference/java/text/ParsePosition pos) ` Parses text from a string to produce an object. | ||
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||
## Constants
### MINIMUM_GROUPING_DIGITS_AUTO
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int MINIMUM_GROUPING_DIGITS_AUTO
```
**\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)` to specify display
grouping using the default strategy for all locales.
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#MINIMUM_GROUPING_DIGITS_MIN2`
Constant Value:
-2
(0xfffffffe)
### MINIMUM_GROUPING_DIGITS_MIN2
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int MINIMUM_GROUPING_DIGITS_MIN2
```
**\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)` to specify display
grouping using locale defaults, except do not show grouping on values smaller than
10000 (such that there is a minimum of two digits before the first separator).
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#MINIMUM_GROUPING_DIGITS_AUTO`
Constant Value:
-3
(0xfffffffd)
### PAD_AFTER_PREFIX
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PAD_AFTER_PREFIX
```
**\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad
characters inserted after the prefix.
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_PREFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_SUFFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_SUFFIX`
Constant Value:
1
(0x00000001)
### PAD_AFTER_SUFFIX
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PAD_AFTER_SUFFIX
```
**\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad
characters inserted after the suffix.
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_PREFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_PREFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_SUFFIX`
Constant Value:
3
(0x00000003)
### PAD_BEFORE_PREFIX
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PAD_BEFORE_PREFIX
```
**\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad
characters inserted before the prefix.
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_PREFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_SUFFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_SUFFIX`
Constant Value:
0
(0x00000000)
### PAD_BEFORE_SUFFIX
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int PAD_BEFORE_SUFFIX
```
**\[icu\]** Constant for `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)` to specify pad
characters inserted before the suffix.
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#getPadPosition()`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_PREFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_PREFIX`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_SUFFIX`
Constant Value:
2
(0x00000002)
## Public constructors
### DecimalFormat
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DecimalFormat ()
```
Creates a DecimalFormat based on the number pattern and symbols for the default locale. This is
a convenient way to obtain a DecimalFormat instance when internationalization is not the main
concern.
Most users should call the factory methods on NumberFormat, such as `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`, which return localized formatter objects, instead of the
DecimalFormat constructors.
**See also:**
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getPercentInstance()`
- `https://developer.android.com/reference/android/icu/util/ULocale.Category#FORMAT`
### DecimalFormat
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DecimalFormat (String pattern)
```
Creates a DecimalFormat based on the given pattern, using symbols for the default locale. This
is a convenient way to obtain a DecimalFormat instance when internationalization is not the
main concern.
Most users should call the factory methods on NumberFormat, such as `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`, which return localized formatter objects, instead of the
DecimalFormat constructors.
| Parameters ||
|---|---|
| `pattern` | `String`: A pattern string such as "#,##0.00" conforming to [UTS #35](http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns).
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the given pattern is invalid. |
**See also:**
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getPercentInstance()`
- `https://developer.android.com/reference/android/icu/util/ULocale.Category#FORMAT`
### DecimalFormat
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DecimalFormat (String pattern,
DecimalFormatSymbols symbols)
```
Creates a DecimalFormat based on the given pattern and symbols. Use this constructor if you
want complete control over the behavior of the formatter.
Most users should call the factory methods on NumberFormat, such as `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`, which return localized formatter objects, instead of the
DecimalFormat constructors.
| Parameters ||
|---|---|
| `pattern` | `String`: A pattern string such as "#,##0.00" conforming to [UTS #35](http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns).
|
| `symbols` | `DecimalFormatSymbols`: The set of symbols to be used.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the given pattern is invalid |
**See also:**
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance()`
- `https://developer.android.com/reference/android/icu/text/NumberFormat#getPercentInstance()`
- `https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols`
### DecimalFormat
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DecimalFormat (String pattern,
DecimalFormatSymbols symbols,
CurrencyPluralInfo infoInput,
int style)
```
Creates a DecimalFormat based on the given pattern and symbols, with additional control over
the behavior of currency. The style argument determines whether currency rounding rules should
override the pattern, and the `https://developer.android.com/reference/android/icu/text/CurrencyPluralInfo` object is used for customizing the
plural forms used for currency long names.
Most users should call the factory methods on NumberFormat, such as `https://developer.android.com/reference/android/icu/text/NumberFormat#getNumberInstance()`, which return localized formatter objects, instead of the
DecimalFormat constructors.
| Parameters ||
|---|---|
| `pattern` | `String`: a non-localized pattern string
|
| `symbols` | `DecimalFormatSymbols`: the set of symbols to be used
|
| `infoInput` | `CurrencyPluralInfo`: the information used for currency plural format, including currency plural patterns and plural rules.
|
| `style` | `int`: the decimal formatting style, it is one of the following values: NumberFormat.NUMBERSTYLE; NumberFormat.CURRENCYSTYLE; NumberFormat.PERCENTSTYLE; NumberFormat.SCIENTIFICSTYLE; NumberFormat.INTEGERSTYLE; NumberFormat.ISOCURRENCYSTYLE; NumberFormat.PLURALCURRENCYSTYLE;
|
## Public methods
### applyLocalizedPattern
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void applyLocalizedPattern (String localizedPattern)
```
Converts the given string to standard notation and then parses it using `https://developer.android.com/reference/android/icu/text/DecimalFormat#applyPattern(java.lang.String)`.
This method is provided for backwards compatibility and should not be used in new projects.
Localized notation means that instead of using generic placeholders in the pattern, you use
the corresponding locale-specific characters instead. For example, in locale *fr-FR*,
the period in the pattern "0.000" means "decimal" in standard notation (as it does in every
other locale), but it means "grouping" in localized notation.
| Parameters ||
|---|---|
| `localizedPattern` | `String`: The pattern string in localized notation.
|
### applyPattern
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void applyPattern (String pattern)
```
Parses the given pattern string and overwrites the settings specified in the pattern string.
The properties corresponding to the following setters are overwritten, either with their
default values or with the value specified in the pattern string:
1. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalSeparatorAlwaysShown(boolean)`
2. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setExponentSignAlwaysShown(boolean)`
3. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`
4. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingSize(int)`
5. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMultiplier(int)` (percent/permille)
6. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)`
7. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumIntegerDigits(int)`
8. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)`
9. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumExponentDigits(byte)`
10. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumFractionDigits(int)`
11. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumIntegerDigits(int)`
12. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumSignificantDigits(int)`
13. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
14. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadCharacter(char)`
15. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`
16. `https://developer.android.com/reference/android/icu/text/DecimalFormat#setSecondaryGroupingSize(int)`
All other settings remain untouched.
For more information on pattern strings, see [UTS #35](http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns).
| Parameters ||
|---|---|
| `pattern` | `String`
|
### areSignificantDigitsUsed
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean areSignificantDigitsUsed ()
```
**\[icu\]** Returns whether significant digits are being used in rounding.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setSignificantDigitsUsed(boolean)`
### clone
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Object clone ()
```
Overrides clone.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Object` | a clone of this instance.
|
### equals
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean equals (Object obj)
```
Tests for equality between this formatter and another formatter.
If two DecimalFormat instances are equal, then they will always produce the same output.
However, the reverse is not necessarily true: if two DecimalFormat instances always produce the
same output, they are not necessarily equal.
| Parameters ||
|---|---|
| `obj` | `Object`: the object to compare against
|
| Returns ||
|---|---|
| `boolean` | true if the object is equal to this.
|
### format
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public StringBuffer format (BigInteger number,
StringBuffer result,
FieldPosition fieldPosition)
```
**\[icu\]** Formats a BigInteger. Specialization of format.
| Parameters ||
|---|---|
| `number` | `BigInteger`
|
| `result` | `StringBuffer`
|
| `fieldPosition` | `FieldPosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/StringBuffer` |
|
### format
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public StringBuffer format (CurrencyAmount currAmt,
StringBuffer result,
FieldPosition fieldPosition)
```
**\[icu\]** Formats a CurrencyAmount. Specialization of format.
| Parameters ||
|---|---|
| `currAmt` | `CurrencyAmount`
|
| `result` | `StringBuffer`
|
| `fieldPosition` | `FieldPosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/StringBuffer` |
|
### format
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public StringBuffer format (BigDecimal number,
StringBuffer result,
FieldPosition fieldPosition)
```
**\[icu\]** Formats an ICU BigDecimal. Specialization of format.
| Parameters ||
|---|---|
| `number` | `BigDecimal`
|
| `result` | `StringBuffer`
|
| `fieldPosition` | `FieldPosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/StringBuffer` |
|
### format
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public StringBuffer format (double number,
StringBuffer result,
FieldPosition fieldPosition)
```
Specialization of format.
| Parameters ||
|---|---|
| `number` | `double`
|
| `result` | `StringBuffer`
|
| `fieldPosition` | `FieldPosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/StringBuffer` |
|
### format
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public StringBuffer format (BigDecimal number,
StringBuffer result,
FieldPosition fieldPosition)
```
**\[icu\]** Formats a BigDecimal. Specialization of format.
| Parameters ||
|---|---|
| `number` | `BigDecimal`
|
| `result` | `StringBuffer`
|
| `fieldPosition` | `FieldPosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/StringBuffer` |
|
### format
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public StringBuffer format (long number,
StringBuffer result,
FieldPosition fieldPosition)
```
Specialization of format.
| Parameters ||
|---|---|
| `number` | `long`
|
| `result` | `StringBuffer`
|
| `fieldPosition` | `FieldPosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/StringBuffer` |
|
### formatToCharacterIterator
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public AttributedCharacterIterator formatToCharacterIterator (Object obj)
```
Formats an Object producing an `AttributedCharacterIterator`.
You can use the returned `AttributedCharacterIterator`
to build the resulting String, as well as to determine information
about the resulting String.
Each attribute key of the AttributedCharacterIterator will be of type
`Field`. It is up to each `Format` implementation
to define what the legal values are for each attribute in the
`AttributedCharacterIterator`, but typically the attribute
key is also used as the attribute value.
The default implementation creates an
`AttributedCharacterIterator` with no attributes. Subclasses
that support fields should override this and create an
`AttributedCharacterIterator` with meaningful attributes.
| Parameters ||
|---|---|
| `obj` | `Object`: The object to format
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/text/AttributedCharacterIterator` | AttributedCharacterIterator describing the formatted value.
|
### getCurrency
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Currency getCurrency ()
```
Returns the currency used to display currency amounts. May be null.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/util/Currency` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrency(android.icu.util.Currency)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols#getCurrency()`
### getCurrencyPluralInfo
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public CurrencyPluralInfo getCurrencyPluralInfo ()
```
**\[icu\]** Returns the current instance of CurrencyPluralInfo.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/text/CurrencyPluralInfo` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrencyPluralInfo(android.icu.text.CurrencyPluralInfo)`
### getCurrencyUsage
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Currency.CurrencyUsage getCurrencyUsage ()
```
**\[icu\]** Returns the strategy for rounding currency amounts.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/util/Currency.CurrencyUsage` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrencyUsage(android.icu.util.Currency.CurrencyUsage)`
### getDecimalFormatSymbols
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DecimalFormatSymbols getDecimalFormatSymbols ()
```
Returns a copy of the decimal format symbols used by this formatter.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols` | desired DecimalFormatSymbols
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols`
### getFormatWidth
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getFormatWidth ()
```
Returns the minimum number of characters in formatted output.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`
### getGroupingSize
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getGroupingSize ()
```
Returns the primary grouping size in use.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingSize(int)`
### getMathContext
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public MathContext getMathContext ()
```
**\[icu\]** Returns the `https://developer.android.com/reference/java/math/MathContext` being used to round numbers.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/math/MathContext` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContext(java.math.MathContext)`
### getMathContextICU
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public MathContext getMathContextICU ()
```
**\[icu\]** Returns the `https://developer.android.com/reference/android/icu/math/MathContext` being used to round numbers.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/math/MathContext` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContext(java.math.MathContext)`
### getMaximumFractionDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMaximumFractionDigits ()
```
Returns the effective maximum number of integer digits after the decimal separator.
| Returns ||
|---|---|
| `int` | the maximum number of fraction digits
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumIntegerDigits(int)`
### getMaximumIntegerDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMaximumIntegerDigits ()
```
Returns the effective maximum number of digits before the decimal separator.
| Returns ||
|---|---|
| `int` | the maximum number of integer digits
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumIntegerDigits(int)`
### getMaximumSignificantDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMaximumSignificantDigits ()
```
**\[icu\]** Returns the effective maximum number of significant digits displayed.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)`
### getMinimumExponentDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public byte getMinimumExponentDigits ()
```
**\[icu\]** Returns the minimum number of digits printed in the exponent in scientific notation.
| Returns ||
|---|---|
| `byte` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumExponentDigits(byte)`
### getMinimumFractionDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMinimumFractionDigits ()
```
Returns the effective minimum number of integer digits after the decimal separator.
| Returns ||
|---|---|
| `int` | the minimum number of fraction digits
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumIntegerDigits(int)`
### getMinimumGroupingDigits
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMinimumGroupingDigits ()
```
**\[icu\]** Returns the minimum number of digits before grouping is triggered.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumGroupingDigits(int)`
### getMinimumIntegerDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMinimumIntegerDigits ()
```
Returns the effective minimum number of digits before the decimal separator.
| Returns ||
|---|---|
| `int` | the minimum number of integer digits
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumIntegerDigits(int)`
### getMinimumSignificantDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMinimumSignificantDigits ()
```
**\[icu\]** Returns the effective minimum number of significant digits displayed.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumSignificantDigits(int)`
### getMultiplier
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getMultiplier ()
```
Returns the multiplier being applied to numbers before they are formatted.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMultiplier(int)`
### getNegativePrefix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getNegativePrefix ()
```
**Affixes:** Gets the negative prefix string currently being used to format
numbers.
If the affix was specified via the pattern, the string returned by this method will have
locale symbols substituted in place of special characters according to the LDML specification.
If the affix was specified via `https://developer.android.com/reference/android/icu/text/DecimalFormat#setNegativePrefix(java.lang.String)`, the string will be returned
literally.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The string being prepended to negative numbers.
|
### getNegativeSuffix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getNegativeSuffix ()
```
**Affixes:** Gets the negative suffix string currently being used to format
numbers.
If the affix was specified via the pattern, the string returned by this method will have
locale symbols substituted in place of special characters according to the LDML specification.
If the affix was specified via `https://developer.android.com/reference/android/icu/text/DecimalFormat#setNegativeSuffix(java.lang.String)`, the string will be returned
literally.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The string being appended to negative numbers.
|
### getPadCharacter
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public char getPadCharacter ()
```
**\[icu\]** Returns the character used for padding.
| Returns ||
|---|---|
| `char` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadCharacter(char)`
### getPadPosition
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getPadPosition ()
```
**\[icu\]** Returns the position used for padding.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
### getParseMaxDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getParseMaxDigits ()
```
**This method was deprecated
in API level 28.**
Setting max parse digits has no effect since ICU4J 59.
Always returns 1000, the default prior to ICU 59.
| Returns ||
|---|---|
| `int` |
|
### getPositivePrefix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getPositivePrefix ()
```
**Affixes:** Gets the positive prefix string currently being used to format
numbers.
If the affix was specified via the pattern, the string returned by this method will have
locale symbols substituted in place of special characters according to the LDML specification.
If the affix was specified via `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPositivePrefix(java.lang.String)`, the string will be returned
literally.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The string being prepended to positive numbers.
|
### getPositiveSuffix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getPositiveSuffix ()
```
**Affixes:** Gets the positive suffix string currently being used to format
numbers.
If the affix was specified via the pattern, the string returned by this method will have
locale symbols substituted in place of special characters according to the LDML specification.
If the affix was specified via `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPositiveSuffix(java.lang.String)`, the string will be returned
literally.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | The string being appended to positive numbers.
|
### getRoundingIncrement
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public BigDecimal getRoundingIncrement ()
```
**\[icu\]** Returns the increment to which numbers are being rounded.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/math/BigDecimal` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`
### getRoundingMode
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getRoundingMode ()
```
Returns the rounding mode being used to round numbers.
| Returns ||
|---|---|
| `int` | A rounding mode, between `BigDecimal.ROUND_UP` and `BigDecimal.ROUND_UNNECESSARY`.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)`
### getSecondaryGroupingSize
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getSecondaryGroupingSize ()
```
**\[icu\]** Returns the secondary grouping size in use.
| Returns ||
|---|---|
| `int` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setSecondaryGroupingSize(int)`
### hashCode
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int hashCode ()
```
Returns a hash code value for the object. This method is
supported for the benefit of hash tables such as those provided by
`https://developer.android.com/reference/java/util/HashMap`.
The general contract of `hashCode` is:
- Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
- If two objects are equal according to the `https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)` method, then calling the `hashCode` method on each of the two objects must produce the same integer result.
- It is *not* required that if two objects are unequal according to the `https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
| Returns ||
|---|---|
| `int` | a hash code value for this object.
|
### isDecimalPatternMatchRequired
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isDecimalPatternMatchRequired ()
```
**\[icu\]** Returns whether the presence of a decimal point must match the pattern.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalPatternMatchRequired(boolean)`
### isDecimalSeparatorAlwaysShown
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isDecimalSeparatorAlwaysShown ()
```
Returns whether the decimal separator is shown on integers.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalSeparatorAlwaysShown(boolean)`
### isExponentSignAlwaysShown
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isExponentSignAlwaysShown ()
```
**\[icu\]** Returns whether the sign (plus or minus) is always printed in scientific notation.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setExponentSignAlwaysShown(boolean)`
### isGroupingUsed
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isGroupingUsed ()
```
Returns whether or not grouping separators are being printed in the output.
| Returns ||
|---|---|
| `boolean` | true if grouping is used
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingUsed(boolean)`
### isParseBigDecimal
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isParseBigDecimal ()
```
Returns whether `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` will always return a BigDecimal.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseBigDecimal(boolean)`
### isParseCaseSensitive
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isParseCaseSensitive ()
```
**\[icu\]** Returns whether to force case (uppercase/lowercase) to match when parsing.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseNoExponent(boolean)`
### isParseIntegerOnly
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isParseIntegerOnly ()
```
Returns true if this format will parse numbers as integers only.
For example in the English locale, with ParseIntegerOnly true, the
string "1234." would be parsed as the integer value 1234 and parsing
would stop at the "." character. The decimal separator accepted
by the parse operation is locale-dependent and determined by the
subclass.
| Returns ||
|---|---|
| `boolean` | true if this will parse integers only
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseIntegerOnly(boolean)`
### isParseNoExponent
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isParseNoExponent ()
```
**\[icu\]** Returns whether to ignore exponents when parsing.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseNoExponent(boolean)`
### isParseStrict
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isParseStrict ()
```
**\[icu\]** Returns whether strict parsing is in effect.
| Returns ||
|---|---|
| `boolean` | true if strict parsing is in effect
|
### isScientificNotation
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isScientificNotation ()
```
**\[icu\]** Returns whether scientific (exponential) notation is enabled on this formatter.
| Returns ||
|---|---|
| `boolean` |
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setScientificNotation(boolean)`
### isSignAlwaysShown
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isSignAlwaysShown ()
```
**\[icu\]** Returns whether the sign is being shown on positive numbers.
| Returns ||
|---|---|
| `boolean` | Whether the sign is shown on positive numbers and zero.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setSignAlwaysShown(boolean)`
### parse
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Number parse (String text,
ParsePosition parsePosition)
```
Returns a Long if possible (e.g., within the range \[Long.MIN_VALUE,
Long.MAX_VALUE\] and with no decimals); otherwise, returns another type,
such as a BigDecimal, BigInteger, or Double. The return type is not
guaranteed other than for the Long case.
If IntegerOnly is set, will stop at a decimal
point (or equivalent; e.g., for rational numbers "1 2/3", will stop
after the 1).
Does not throw an exception; if no object can be parsed, index is
unchanged!
For more detail on parsing, see the "Parsing" header in the class
documentation of `https://developer.android.com/reference/android/icu/text/DecimalFormat`.
| Parameters ||
|---|---|
| `text` | `String`
|
| `parsePosition` | `ParsePosition`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Number` |
|
### parseCurrency
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public CurrencyAmount parseCurrency (CharSequence text,
ParsePosition parsePosition)
```
Parses text from the given string as a CurrencyAmount. Unlike
the parse() method, this method will attempt to parse a generic
currency name, searching for a match of this object's locale's
currency display names, or for a 3-letter ISO currency code.
This method will fail if this format is not a currency format,
that is, if it does not contain the currency pattern symbol
(U+00A4) in its prefix or suffix.
| Parameters ||
|---|---|
| `text` | `CharSequence`: the text to parse
|
| `parsePosition` | `ParsePosition`: input-output position; on input, the position within text to match; must have 0 \<= pos.getIndex() \< text.length(); on output, the position after the last matched character. If the parse fails, the position in unchanged upon output.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/util/CurrencyAmount` | a CurrencyAmount, or null upon failure
|
### setCurrency
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setCurrency (Currency currency)
```
Sets the currency to be used when formatting numbers. The effect is twofold:
1. Substitutions for currency symbols in the pattern string will use this currency
2. The rounding mode will obey the rules for this currency (see `https://developer.android.com/reference/android/icu/text/DecimalFormat#setCurrencyUsage(android.icu.util.Currency.CurrencyUsage)`)
**Important:** Displaying the currency in the output requires that the patter associated with this formatter contains a currency symbol '¤'. This will be the case if the instance was created via `https://developer.android.com/reference/android/icu/text/NumberFormat#getCurrencyInstance()` or one of its friends.
| Parameters ||
|---|---|
| `currency` | `Currency`: The currency to use.
|
### setCurrencyPluralInfo
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setCurrencyPluralInfo (CurrencyPluralInfo newInfo)
```
**\[icu\]** Sets a custom instance of CurrencyPluralInfo. CurrencyPluralInfo generates pattern
strings for printing currency long names.
**Most users should not call this method directly.** You should instead create
your formatter via `NumberFormat.getInstance(NumberFormat.PLURALCURRENCYSTYLE)`.
| Parameters ||
|---|---|
| `newInfo` | `CurrencyPluralInfo`: The CurrencyPluralInfo to use when printing currency long names.
|
### setCurrencyUsage
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setCurrencyUsage (Currency.CurrencyUsage usage)
```
**\[icu\]** Sets the currency-dependent strategy to use when rounding numbers. There are two
strategies:
- STANDARD: When the amount displayed is intended for banking statements or electronic transfer.
- CASH: When the amount displayed is intended to be representable in physical currency, like at a cash register.
CASH mode is relevant in currencies that do not have tender down to the penny. For more information on the two rounding strategies, see [UTS
#35](http://unicode.org/reports/tr35/tr35-numbers.html#Supplemental_Currency_Data). If omitted, the strategy defaults to STANDARD. To override currency rounding altogether, use `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumFractionDigits(int)` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)` or `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`.
| Parameters ||
|---|---|
| `usage` | `Currency.CurrencyUsage`: The strategy to use when rounding in the current currency.
|
### setDecimalFormatSymbols
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setDecimalFormatSymbols (DecimalFormatSymbols newSymbols)
```
Sets the decimal format symbols used by this formatter. The formatter uses a copy of the
provided symbols.
| Parameters ||
|---|---|
| `newSymbols` | `DecimalFormatSymbols`: desired DecimalFormatSymbols
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormatSymbols`
### setDecimalPatternMatchRequired
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setDecimalPatternMatchRequired (boolean value)
```
**\[icu\]** **Parsing:** This method is used to either *require* or
*forbid* the presence of a decimal point in the string being parsed (disabled by
default). This feature was designed to be an extra layer of strictness on top of strict
parsing, although it can be used in either lenient mode or strict mode.
To *require* a decimal point, call this method in combination with either a pattern
containing a decimal point or with `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalSeparatorAlwaysShown(boolean)`.
```
// Require a decimal point in the string being parsed:
df.applyPattern("#.");
df.setDecimalPatternMatchRequired(true);
// Alternatively:
df.setDecimalSeparatorAlwaysShown(true);
df.setDecimalPatternMatchRequired(true);
```
To *forbid* a decimal point, call this method in combination with a pattern containing no decimal point. Alternatively, use `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseIntegerOnly(boolean)` for the same behavior without depending on the contents of the pattern string.
```
// Forbid a decimal point in the string being parsed:
df.applyPattern("#");
df.setDecimalPatternMatchRequired(true);
```
| Parameters ||
|---|---|
| `value` | `boolean`: true to either require or forbid the decimal point according to the pattern; false to disable this feature.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setParseIntegerOnly(boolean)`
### setDecimalSeparatorAlwaysShown
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setDecimalSeparatorAlwaysShown (boolean value)
```
**Separators:** Sets whether the decimal separator (a period in *en-US*) is
shown on integers. For example, if this setting is turned on, formatting 123 will result in
"123." with the decimal separator.
This setting can be specified in the pattern for integer formats: "#,##0." is an example.
| Parameters ||
|---|---|
| `value` | `boolean`: true to always show the decimal separator; false to show it only when there is a fraction part of the number.
|
### setExponentSignAlwaysShown
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setExponentSignAlwaysShown (boolean expSignAlways)
```
**\[icu\]** **Scientific Notation:** Sets whether the sign (plus or minus) is always to
be shown in the exponent in scientific notation. For example, if this setting is enabled, the
number 123000 will be printed as "1.23E+5" in locale *en-US* . The number 0.0000123 will
always be printed as "1.23E-5" in locale *en-US* whether or not this setting is enabled.
This setting corresponds to the '+' in a pattern such as "0.00E+0".
| Parameters ||
|---|---|
| `expSignAlways` | `boolean`: true to always shown the sign in the exponent; false to show it for negatives but not positives.
|
### setFormatWidth
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setFormatWidth (int width)
```
**Padding:** Sets the minimum width of the string output by the formatting
pipeline. For example, if padding is enabled and paddingWidth is set to 6, formatting the
number "3.14159" with the pattern "0.00" will result in "··3.14" if '·' is your padding string.
If the number is longer than your padding width, the number will display as if no padding
width had been specified, which may result in strings longer than the padding width.
Padding can be specified in the pattern string using the '\*' symbol. For example, the format
"\*x######0" has a format width of 7 and a pad character of 'x'.
Padding is currently counted in UTF-16 code units; see [ticket #13034](https://unicode-org.atlassian.net/browse/ICU-13034) for more information.
| Parameters ||
|---|---|
| `width` | `int`: The minimum number of characters in the output.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadCharacter(char)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setPadPosition(int)`
### setGroupingSize
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setGroupingSize (int width)
```
**Grouping:** Sets the primary grouping size (distance between grouping
separators) used when formatting large numbers. For most locales, this defaults to 3: the
number of digits between the ones and thousands place, between thousands and millions, and so
forth.
For example, with a grouping size of 3, the number 1234567 will be formatted as "1,234,567".
Grouping size can also be specified in the pattern: for example, "#,##0" corresponds to a
grouping size of 3.
| Parameters ||
|---|---|
| `width` | `int`: The grouping size to use.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setSecondaryGroupingSize(int)`
### setGroupingUsed
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setGroupingUsed (boolean enabled)
```
**Grouping:** Sets whether grouping is to be used when formatting numbers.
Grouping means whether the thousands, millions, billions, and larger powers of ten should be
separated by a grouping separator (a comma in *en-US*).
For example, if grouping is enabled, 12345 will be printed as "12,345" in *en-US*. If
grouping were disabled, it would instead be printed as simply "12345".
| Parameters ||
|---|---|
| `enabled` | `boolean`: true to enable grouping separators; false to disable them.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingSize(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setSecondaryGroupingSize(int)`
### setMathContext
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMathContext (MathContext mathContext)
```
**\[icu\]** **Rounding and Digit Limits:** Sets the `https://developer.android.com/reference/java/math/MathContext` used
to round numbers. A "math context" encodes both a rounding mode and a number of significant
digits. Most users should call `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)` and/or `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)` instead of this method.
When formatting, since no division is ever performed, the default MathContext is unlimited
significant digits. However, when division occurs during parsing to correct for percentages and
multipliers, a MathContext of 34 digits, the IEEE 754R Decimal128 standard, is used by default.
If you require more than 34 digits when parsing, you can set a custom MathContext using this
method.
| Parameters ||
|---|---|
| `mathContext` | `MathContext`: The MathContext to use when rounding numbers.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/ArithmeticException` | when inverting multiplier produces a non-terminating decimal result in conjunction with MathContext of unlimited precision. |
**See also:**
- `https://developer.android.com/reference/java/math/MathContext`
### setMathContextICU
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMathContextICU (MathContext mathContextICU)
```
**\[icu\]** **Rounding and Digit Limits:** Overload of `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContext(java.math.MathContext)` for
`https://developer.android.com/reference/android/icu/math/MathContext`.
| Parameters ||
|---|---|
| `mathContextICU` | `MathContext`: The MathContext to use when rounding numbers.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/ArithmeticException` | when inverting multiplier produces a non-terminating decimal result in conjunction with MathContext of unlimited precision. |
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMathContext(java.math.MathContext)`
### setMaximumFractionDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMaximumFractionDigits (int value)
```
**Rounding and Digit Limits:** Sets the maximum number of digits to display after
the decimal separator. If the number has more than this many digits, the number is rounded
according to the rounding mode.
For example, if maximum fraction digits is 2, the number 123.456 will be printed as
"123.46".
Minimum integer and minimum and maximum fraction digits can be specified via the pattern
string. For example, "#,#00.00#" has 2 minimum integer digits, 2 minimum fraction digits, and 3
maximum fraction digits. Note that it is not possible to specify maximum integer digits in the
pattern except in scientific notation.
If minimum and maximum integer, fraction, or significant digits conflict with each other,
the most recently specified value is used. For example, if there is a formatter with minInt=5,
and then you set maxInt=3, then minInt will be changed to 3.
| Parameters ||
|---|---|
| `value` | `int`: The maximum number of integer digits after the decimal separator.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)`
### setMaximumIntegerDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMaximumIntegerDigits (int value)
```
**Rounding and Digit Limits:** Sets the maximum number of digits to display before
the decimal separator. If the number has more than this many digits, the number is truncated.
For example, if maximum integer digits is 3, the number 12345 will be printed as "345".
Minimum integer and minimum and maximum fraction digits can be specified via the pattern
string. For example, "#,#00.00#" has 2 minimum integer digits, 2 minimum fraction digits, and 3
maximum fraction digits. Note that it is not possible to specify maximum integer digits in the
pattern except in scientific notation.
If minimum and maximum integer, fraction, or significant digits conflict with each other,
the most recently specified value is used. For example, if there is a formatter with minInt=5,
and then you set maxInt=3, then minInt will be changed to 3.
| Parameters ||
|---|---|
| `value` | `int`: The maximum number of digits before the decimal separator.
|
### setMaximumSignificantDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMaximumSignificantDigits (int value)
```
**\[icu\]** **Rounding and Digit Limits:** Sets the maximum number of significant
digits to be displayed. If the number of significant digits in the number exceeds this value,
the number will be rounded according to the current rounding mode.
For example, if maximum significant digits is 3 and the number is 12345, the number will be
printed as "12300".
If minimum and maximum integer, fraction, or significant digits conflict with each other,
the most recently specified value is used. For example, if there is a formatter with minInt=5,
and then you set maxInt=3, then minInt will be changed to 3.
See `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)` for two other ways
of specifying rounding strategies.
| Parameters ||
|---|---|
| `value` | `int`: The maximum number of significant digits to display.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)`
### setMinimumExponentDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMinimumExponentDigits (byte minExpDig)
```
**\[icu\]** **Scientific Notation:** Sets the minimum number of digits to be printed in
the exponent. For example, if minimum exponent digits is 3, the number 123000 will be printed
as "1.23E005".
This setting corresponds to the number of zeros after the 'E' in a pattern string such as
"0.00E000".
| Parameters ||
|---|---|
| `minExpDig` | `byte`: The minimum number of digits in the exponent.
|
### setMinimumFractionDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMinimumFractionDigits (int value)
```
**Rounding and Digit Limits:** Sets the minimum number of digits to display after
the decimal separator. If the number has fewer than this many digits, the number is padded with
zeros.
For example, if minimum fraction digits is 2, the number 123.4 will be printed as "123.40".
Minimum integer and minimum and maximum fraction digits can be specified via the pattern
string. For example, "#,#00.00#" has 2 minimum integer digits, 2 minimum fraction digits, and 3
maximum fraction digits. Note that it is not possible to specify maximum integer digits in the
pattern except in scientific notation.
If minimum and maximum integer, fraction, or significant digits conflict with each other,
the most recently specified value is used. For example, if there is a formatter with minInt=5,
and then you set maxInt=3, then minInt will be changed to 3.
See `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)` for two other
ways of specifying rounding strategies.
| Parameters ||
|---|---|
| `value` | `int`: The minimum number of integer digits after the decimal separator.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)`
### setMinimumGroupingDigits
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMinimumGroupingDigits (int number)
```
**\[icu\]** Sets the minimum number of digits that must be before the first grouping separator in
order for the grouping separator to be printed. For example, if minimum grouping digits is set
to 2, in *en-US*, 1234 will be printed as "1234" and 12345 will be printed as "12,345".
Set the value to:
- 1 to turn off minimum grouping digits.
- MINIMUM_GROUPING_DIGITS_AUTO to display grouping using the default strategy for all locales.
- MINIMUM_GROUPING_DIGITS_MIN2 to display grouping using locale defaults, except do not show grouping on values smaller than 10000 (such that there is a minimum of two digits before the first separator).
| Parameters ||
|---|---|
| `number` | `int`: The minimum number of digits before grouping is triggered.
|
### setMinimumIntegerDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMinimumIntegerDigits (int value)
```
**Rounding and Digit Limits:** Sets the minimum number of digits to display before
the decimal separator. If the number has fewer than this many digits, the number is padded with
zeros.
For example, if minimum integer digits is 3, the number 12.3 will be printed as "001.23".
Minimum integer and minimum and maximum fraction digits can be specified via the pattern
string. For example, "#,#00.00#" has 2 minimum integer digits, 2 minimum fraction digits, and 3
maximum fraction digits. Note that it is not possible to specify maximum integer digits in the
pattern except in scientific notation.
If minimum and maximum integer, fraction, or significant digits conflict with each other,
the most recently specified value is used. For example, if there is a formatter with minInt=5,
and then you set maxInt=3, then minInt will be changed to 3.
| Parameters ||
|---|---|
| `value` | `int`: The minimum number of digits before the decimal separator.
|
### setMinimumSignificantDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMinimumSignificantDigits (int value)
```
**\[icu\]** **Rounding and Digit Limits:** Sets the minimum number of significant
digits to be displayed. If the number of significant digits is less than this value, the number
will be padded with zeros as necessary.
For example, if minimum significant digits is 3 and the number is 1.2, the number will be
printed as "1.20".
If minimum and maximum integer, fraction, or significant digits conflict with each other,
the most recently specified value is used. For example, if there is a formatter with minInt=5,
and then you set maxInt=3, then minInt will be changed to 3.
| Parameters ||
|---|---|
| `value` | `int`: The minimum number of significant digits to display.
|
### setMultiplier
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setMultiplier (int multiplier)
```
Sets a number that will be used to multiply all numbers prior to formatting. For example, when
formatting percents, a multiplier of 100 can be used.
If a percent or permille sign is specified in the pattern, the multiplier is automatically
set to 100 or 1000, respectively.
If the number specified here is a power of 10, a more efficient code path will be used.
| Parameters ||
|---|---|
| `multiplier` | `int`: The number by which all numbers passed to `https://developer.android.com/reference/android/icu/text/NumberFormat#format(android.icu.math.BigDecimal)` will be multiplied.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/ArithmeticException` | when inverting multiplier produces a non-terminating decimal result in conjunction with MathContext of unlimited precision. |
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | If the given multiplier is zero. |
### setNegativePrefix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setNegativePrefix (String prefix)
```
**Affixes:** Sets the string to prepend to negative numbers. For example, if you
set the value "#", then the number -123 will be formatted as "#123" in the locale
*en-US* (overriding the implicit default '-' in the pattern).
Using this method overrides the affix specified via the pattern, and unlike the pattern, the
string given to this method will be interpreted literally WITHOUT locale symbol substitutions.
| Parameters ||
|---|---|
| `prefix` | `String`: The literal string to prepend to negative numbers.
|
### setNegativeSuffix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setNegativeSuffix (String suffix)
```
**Affixes:** Sets the string to append to negative numbers. For example, if you
set the value "#", then the number 123 will be formatted as "123#" in the locale
*en-US*.
Using this method overrides the affix specified via the pattern, and unlike the pattern, the
string given to this method will be interpreted literally WITHOUT locale symbol substitutions.
| Parameters ||
|---|---|
| `suffix` | `String`: The literal string to append to negative numbers.
|
### setPadCharacter
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setPadCharacter (char padChar)
```
**\[icu\]** **Padding:** Sets the character used to pad numbers that are narrower than
the width specified in `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`.
In the pattern string, the padding character is the token that follows '\*' before or after
the prefix or suffix.
| Parameters ||
|---|---|
| `padChar` | `char`: The character used for padding.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`
### setPadPosition
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setPadPosition (int padPos)
```
**\[icu\]** **Padding:** Sets the position where to insert the pad character when
narrower than the width specified in `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`. For example, consider the pattern
"P123S" with padding width 8 and padding char "\*". The four positions are:
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_PREFIX` \\u21d2 "\*\*\*P123S"
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_PREFIX` \\u21d2 "P\*\*\*123S"
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_BEFORE_SUFFIX` \\u21d2 "P123\*\*\*S"
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#PAD_AFTER_SUFFIX` \\u21d2 "P123S\*\*\*"
| Parameters ||
|---|---|
| `padPos` | `int`: The position used for padding.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setFormatWidth(int)`
### setParseBigDecimal
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setParseBigDecimal (boolean value)
```
Whether to make `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` prefer returning a `https://developer.android.com/reference/android/icu/math/BigDecimal` when
possible. For strings corresponding to return values of Infinity, -Infinity, NaN, and -0.0, a
Double will be returned even if ParseBigDecimal is enabled.
| Parameters ||
|---|---|
| `value` | `boolean`: true to cause `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` to prefer BigDecimal; false to let `https://developer.android.com/reference/android/icu/text/NumberFormat#parse(java.lang.String)` return additional data types like Long or BigInteger.
|
### setParseCaseSensitive
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setParseCaseSensitive (boolean value)
```
**\[icu\]** Specifies whether parsing should require cases to match in affixes, exponent separators,
and currency codes. Case mapping is performed for each code point using `https://developer.android.com/reference/android/icu/lang/UCharacter#foldCase(int,%20boolean)`.
| Parameters ||
|---|---|
| `value` | `boolean`: true to force case (uppercase/lowercase) to match when parsing; false to ignore case and perform case folding.
|
### setParseIntegerOnly
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setParseIntegerOnly (boolean parseIntegerOnly)
```
**Parsing:** Sets whether to ignore the fraction part of a number when parsing
(defaults to false). If a string contains a decimal point, parsing will stop before the decimal
point. Note that determining whether a character is a decimal point depends on the locale.
For example, in *en-US*, parsing the string "123.45" will return the number 123 and
parse position 3.
This is functionally equivalent to calling `https://developer.android.com/reference/android/icu/text/DecimalFormat#setDecimalPatternMatchRequired(boolean)` and a
pattern without a decimal point.
| Parameters ||
|---|---|
| `parseIntegerOnly` | `boolean`: true to ignore fractional parts of numbers when parsing; false to consume fractional parts.
|
### setParseMaxDigits
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level
28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setParseMaxDigits (int maxDigits)
```
**This method was deprecated
in API level 28.**
Setting max parse digits has no effect since ICU4J 59.
| Parameters ||
|---|---|
| `maxDigits` | `int`: Prior to ICU 59, the maximum number of digits in the output number after exponential notation is applied.
|
### setParseNoExponent
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setParseNoExponent (boolean value)
```
**\[icu\]** Specifies whether to stop parsing when an exponent separator is encountered. For
example, parses "123E4" to 123 (with parse position 3) instead of 1230000 (with parse position
5).
| Parameters ||
|---|---|
| `value` | `boolean`: true to prevent exponents from being parsed; false to allow them to be parsed.
|
### setParseStrict
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setParseStrict (boolean parseStrict)
```
**\[icu\]** Sets whether strict parsing is in effect. When this is true, the string
is required to be a stronger match to the pattern than when lenient parsing is in
effect. More specifically, the following conditions cause a parse failure relative
to lenient mode (examples use the pattern "#,##0.#"):
- The presence and position of special symbols, including currency, must match the pattern.
'+123' fails (there is no plus sign in the pattern)
- Leading or doubled grouping separators
',123' and '1,,234" fail
- Groups of incorrect length when grouping is used
'1,23' and '1234,567' fail, but '1234' passes
- Grouping separators used in numbers followed by exponents
'1,234E5' fails, but '1234E5' and '1,234E' pass ('E' is not an exponent when not followed by a number)
When strict parsing is off, all grouping separators are ignored. This is the default behavior.
| Parameters ||
|---|---|
| `parseStrict` | `boolean`: True to enable strict parsing. Default is false.
|
### setPositivePrefix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setPositivePrefix (String prefix)
```
**Affixes:** Sets the string to prepend to positive numbers. For example, if you
set the value "#", then the number 123 will be formatted as "#123" in the locale
*en-US*.
Using this method overrides the affix specified via the pattern, and unlike the pattern, the
string given to this method will be interpreted literally WITHOUT locale symbol substitutions.
| Parameters ||
|---|---|
| `prefix` | `String`: The literal string to prepend to positive numbers.
|
### setPositiveSuffix
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setPositiveSuffix (String suffix)
```
**Affixes:** Sets the string to append to positive numbers. For example, if you
set the value "#", then the number 123 will be formatted as "123#" in the locale
*en-US*.
Using this method overrides the affix specified via the pattern, and unlike the pattern, the
string given to this method will be interpreted literally WITHOUT locale symbol substitutions.
| Parameters ||
|---|---|
| `suffix` | `String`: The literal string to append to positive numbers.
|
### setRoundingIncrement
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setRoundingIncrement (BigDecimal increment)
```
**\[icu\]** **Rounding and Digit Limits:** Sets an increment, or interval, to which
numbers are rounded. For example, a rounding increment of 0.05 will cause the number 1.23 to be
rounded to 1.25 in the default rounding mode.
The rounding increment can be specified via the pattern string: for example, the pattern
"#,##0.05" encodes a rounding increment of 0.05.
The rounding increment is applied *after* any multipliers might take effect; for
example, in scientific notation or when `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMultiplier(int)` is used.
See `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)` and `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)` for two other
ways of specifying rounding strategies.
| Parameters ||
|---|---|
| `increment` | `BigDecimal`: The increment to which numbers are to be rounded.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingMode(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumFractionDigits(int)`
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMaximumSignificantDigits(int)`
### setRoundingIncrement
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setRoundingIncrement (BigDecimal increment)
```
**\[icu\]** **Rounding and Digit Limits:** Overload of `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(java.math.BigDecimal)`.
| Parameters ||
|---|---|
| `increment` | `BigDecimal`: The increment to which numbers are to be rounded.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`
### setRoundingIncrement
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setRoundingIncrement (double increment)
```
**\[icu\]** **Rounding and Digit Limits:** Overload of `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(java.math.BigDecimal)`.
| Parameters ||
|---|---|
| `increment` | `double`: The increment to which numbers are to be rounded.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setRoundingIncrement(android.icu.math.BigDecimal)`
### setRoundingMode
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setRoundingMode (int roundingMode)
```
**Rounding and Digit Limits:** Sets the `https://developer.android.com/reference/java/math/RoundingMode` used to round
numbers. The default rounding mode is HALF_EVEN, which rounds decimals to their closest whole
number, and rounds to the closest even number if at the midpoint.
For more detail on rounding modes, see [the ICU
User Guide](https://unicode-org.github.io/icu/userguide/format_parse/numbers/rounding-modes).
For backwards compatibility, the rounding mode is specified as an int argument, which can be
from either the constants in `https://developer.android.com/reference/android/icu/math/BigDecimal` or the ordinal value of `https://developer.android.com/reference/java/math/RoundingMode`.
The following two calls are functionally equivalent.
```
df.setRoundingMode(BigDecimal.ROUND_CEILING);
df.setRoundingMode(RoundingMode.CEILING.ordinal());
```
| Parameters ||
|---|---|
| `roundingMode` | `int`: The integer constant rounding mode to use when formatting numbers.
|
### setScientificNotation
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setScientificNotation (boolean useScientific)
```
**\[icu\]** **Scientific Notation:** Sets whether this formatter should print in
scientific (exponential) notation. For example, if scientific notation is enabled, the number
123000 will be printed as "1.23E5" in locale *en-US*. A locale-specific symbol is used
as the exponent separator.
Calling `df.setScientificNotation(true)` is functionally equivalent to calling
`df.setMinimumExponentDigits(1)`.
| Parameters ||
|---|---|
| `useScientific` | `boolean`: true to enable scientific notation; false to disable it.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setMinimumExponentDigits(byte)`
### setSecondaryGroupingSize
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setSecondaryGroupingSize (int width)
```
**\[icu\]** **Grouping:** Sets the secondary grouping size (distance between grouping
separators after the first separator) used when formatting large numbers. In many south Asian
locales, this is set to 2.
For example, with primary grouping size 3 and secondary grouping size 2, the number 1234567
will be formatted as "12,34,567".
Grouping size can also be specified in the pattern: for example, "#,##,##0" corresponds to a
primary grouping size of 3 and a secondary grouping size of 2.
| Parameters ||
|---|---|
| `width` | `int`: The secondary grouping size to use.
|
**See also:**
- `https://developer.android.com/reference/android/icu/text/DecimalFormat#setGroupingSize(int)`
### setSignAlwaysShown
Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setSignAlwaysShown (boolean value)
```
Sets whether to always shown the plus sign ('+' in *en*) on positive numbers. The rules
in UTS #35 section 3.2.1 will be followed to ensure a locale-aware placement of the sign.
More specifically, the following strategy will be used to place the plus sign:
1. *Patterns without a negative subpattern:* The locale's plus sign will be prepended to the positive prefix.
2. *Patterns with a negative subpattern without a '-' sign (e.g., accounting):* The locale's plus sign will be prepended to the positive prefix, as in case 1.
3. *Patterns with a negative subpattern that has a '-' sign:* The locale's plus sign will substitute the '-' in the negative subpattern. The positive subpattern will be unused.
This method is designed to be used *instead of* applying a pattern containing an explicit plus sign, such as "+0;-0". The behavior when combining this method with explicit plus signs in the pattern is undefined.
| Parameters ||
|---|---|
| `value` | `boolean`: true to always show a sign; false to hide the sign on positive numbers and zero.
|
### setSignificantDigitsUsed
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setSignificantDigitsUsed (boolean useSignificantDigits)
```
**\[icu\]** **Rounding and Digit Limits:** Sets whether significant digits are to be
used in rounding.
Calling `df.setSignificantDigitsUsed(true)` is functionally equivalent to:
```
df.setMinimumSignificantDigits(1);
df.setMaximumSignificantDigits(6);
```
| Parameters ||
|---|---|
| `useSignificantDigits` | `boolean`: true to enable significant digit rounding; false to disable it.
|
### toLocalizedPattern
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String toLocalizedPattern ()
```
Calls `https://developer.android.com/reference/android/icu/text/DecimalFormat#toPattern()` and converts the string to localized notation. For more information on
localized notation, see `https://developer.android.com/reference/android/icu/text/DecimalFormat#applyLocalizedPattern(java.lang.String)`. This method is provided for backwards
compatibility and should not be used in new projects.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | A decimal format pattern string in localized notation.
|
### toPattern
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String toPattern ()
```
Serializes this formatter object to a decimal format pattern string. The result of this method
is guaranteed to be *functionally* equivalent to the pattern string used to create this
instance after incorporating values from the setter methods.
For more information on decimal format pattern strings, see [UTS #35](http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns).
**Important:** Not all properties are capable of being encoded in a pattern
string. See a list of properties in `https://developer.android.com/reference/android/icu/text/DecimalFormat#applyPattern(java.lang.String)`.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | A decimal format pattern string.
|
### toString
Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String toString ()
```
Returns the default value of toString() with extra DecimalFormat-specific information appended
to the end of the string. This extra information is intended for debugging purposes, and the
format is not guaranteed to be stable.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of the object.
|