DecimalFormat

public class DecimalFormat
extends NumberFormat

Known Direct Subclasses CompactDecimalFormat CompactDecimalFormat The CompactDecimalFormat produces abbreviated numbers, suitable for display in environments will limited real estate.

[icu enhancement] ICU's replacement for DecimalFormat. Methods, fields, and other functionality specific to ICU are labeled '[icu]'. DecimalFormat is a concrete subclass of NumberFormat that formats decimal numbers. 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 also 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 NumberFormat for a specific locale (including the default locale) call one of NumberFormat's factory methods such as getInstance(). Do not call the DecimalFormat constructors directly, unless you know what you are doing, since the NumberFormat factory methods may return subclasses other than DecimalFormat. If you need to customize the format object, do something like this:

 NumberFormat f = NumberFormat.getInstance(loc);
 if (f instanceof DecimalFormat) {
     ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true);
 }

Example Usage Print out a number using the localized number, currency, and percent format for each locale.

 Locale[] locales = NumberFormat.getAvailableLocales();
 double myNumber = -1234.56;
 NumberFormat format;
 for (int j=0; j<3; ++j) {
     System.out.println("FORMAT");
     for (int i = 0; i < locales.length; ++i) {
         if (locales[i].getCountry().length() == 0) {
            // Skip language-only locales
            continue;
         }
         System.out.print(locales[i].getDisplayName());
         switch (j) {
         case 0:
             format = NumberFormat.getInstance(locales[i]); break;
         case 1:
             format = NumberFormat.getCurrencyInstance(locales[i]); break;
         default:
             format = NumberFormat.getPercentInstance(locales[i]); break;
         }
         try {
             // Assume format is a DecimalFormat
             System.out.print(": " + ((DecimalFormat) format).toPattern()
                              + " -> " + form.format(myNumber));
         } catch (Exception e) {}
         try {
             System.out.println(" -> " + format.parse(form.format(myNumber)));
         } catch (ParseException e) {}
     }
 }

Another example use getInstance(style).
Print out a number using the localized number, currency, percent, scientific, integer, iso currency, and plural currency format for each locale.

 ULocale locale = new ULocale("en_US");
 double myNumber = 1234.56;
 for (int j=NumberFormat.NUMBERSTYLE; j<=NumberFormat.PLURALCURRENCYSTYLE; ++j) {
     NumberFormat format = NumberFormat.getInstance(locale, j);
     try {
         // Assume format is a DecimalFormat
         System.out.print(": " + ((DecimalFormat) format).toPattern()
                          + " -> " + form.format(myNumber));
     } catch (Exception e) {}
     try {
         System.out.println(" -> " + format.parse(form.format(myNumber)));
     } catch (ParseException e) {}
 }

Patterns

A DecimalFormat consists of a pattern and a set of symbols. The pattern may be set directly using applyPattern(String), or indirectly using other API methods which manipulate aspects of the pattern, such as the minimum number of integer digits. The symbols are stored in a DecimalFormatSymbols object. When using the NumberFormat factory methods, the pattern and symbols are read from ICU's locale data.

Special Pattern Characters

Many characters in a pattern are taken literally; they are matched during parsing and output unchanged during formatting. Special characters, on the other hand, stand for other characters, strings, or classes of characters. For example, the '#' character is replaced by a localized digit. Often the replacement character is the same as the pattern character; in the U.S. locale, the ',' grouping character is replaced by ','. However, the replacement is still happening, and if the symbols are modified, the grouping character changes. Some special characters affect the behavior of the formatter by their presence; for example, if the percent character is seen, then the value is multiplied by 100 before being displayed.

To insert a special character in a pattern as a literal, that is, without any special meaning, the character must be quoted. There are some exceptions to this which are noted below.

The characters listed here are used in non-localized patterns. Localized patterns use the corresponding characters taken from this formatter's DecimalFormatSymbols object instead, and these characters lose their special status. Two exceptions are the currency sign and quote, which are not localized.

Symbol	Location	Localized?	Meaning
0	Number	Yes	Digit
1-9	Number	Yes	'1' through '9' indicate rounding.
@	Number	No	Significant digit
#	Number	Yes	Digit, zero shows as absent
.	Number	Yes	Decimal separator or monetary decimal separator
-	Number	Yes	Minus sign
,	Number	Yes	Grouping separator
E	Number	Yes	Separates mantissa and exponent in scientific notation. Need not be quoted in prefix or suffix.
+	Exponent	Yes	Prefix positive exponents with localized plus sign. Need not be quoted in prefix or suffix.
;	Subpattern boundary	Yes	Separates positive and negative subpatterns
%	Prefix or suffix	Yes	Multiply by 100 and show as percentage
\u2030	Prefix or suffix	Yes	Multiply by 1000 and show as per mille
¤ (\u00A4)	Prefix or suffix	No	Currency sign, replaced by currency symbol. If doubled, replaced by international currency symbol. If tripled, replaced by currency plural names, for example, "US dollar" or "US dollars" for America. If present in a pattern, the monetary decimal separator is used instead of the decimal separator.
'	Prefix or suffix	No	Used to quote special characters in a prefix or suffix, for example, "'#'#" formats 123 to "#123". To create a single quote itself, use two in a row: "# o''clock".
*	Prefix or suffix boundary	Yes	Pad escape, precedes pad character

A DecimalFormat pattern contains a postive and negative subpattern, for example, "#,##0.00;(#,##0.00)". Each subpattern has a prefix, a numeric part, and a suffix. If there is no explicit negative subpattern, the negative subpattern is the localized minus sign prefixed to the positive subpattern. That is, "0.00" alone is equivalent to "0.00;-0.00". If there is an explicit negative subpattern, it serves only to specify the negative prefix and suffix; the number of digits, minimal digits, and other characteristics are ignored in the negative subpattern. That means that "#,##0.0#;(#)" has precisely the same result as "#,##0.0#;(#,##0.0#)".

The prefixes, suffixes, and various symbols used for infinity, digits, thousands separators, decimal separators, etc. may be set to arbitrary values, and they will appear properly during formatting. However, care must be taken that the symbols and strings do not conflict, or parsing will be unreliable. For example, either the positive and negative prefixes or the suffixes must be distinct for parse(String) to be able to distinguish positive from negative values. Another example is that the decimal separator and thousands separator should be distinct characters, or parsing will be impossible.

The grouping separator is a character that separates clusters of integer digits to make large numbers more legible. It commonly used for thousands, but in some locales it separates ten-thousands. The grouping size is the number of digits between the grouping separators, such as 3 for "100,000,000" or 4 for "1 0000 0000". There are actually two different grouping sizes: One used for the least significant integer digits, the primary grouping size, and one used for all others, the secondary grouping size. In most locales these are the same, but sometimes they are different. For example, if the primary grouping interval is 3, and the secondary is 2, then this corresponds to the pattern "#,##,##0", and the number 123456789 is formatted as "12,34,56,789". If a pattern contains multiple grouping separators, the interval between the last one and the end of the integer defines the primary grouping size, and the interval between the last two defines the secondary grouping size. All others are ignored, so "#,##,###,####" == "###,###,####" == "##,#,###,####".

Illegal patterns, such as "#.#.#" or "#.###,###", will cause DecimalFormat to throw an IllegalArgumentException with a message that describes the problem.

Pattern BNF

 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
 

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 parses all Unicode characters that represent decimal digits, as defined by digit(int). In addition, DecimalFormat also recognizes as digits the ten consecutive characters starting with the localized zero digit defined in the DecimalFormatSymbols object. During formatting, the DecimalFormatSymbols-based digits are output.

During parsing, grouping separators are ignored.

For currency parsing, the formatter is able to parse every currency style formats no matter which style the formatter is constructed with. For example, a formatter instance gotten from NumberFormat.getInstance(ULocale, NumberFormat.CURRENCYSTYLE) can parse formats such as "USD1.00" and "3.00 US dollars".

If parse(String, ParsePosition) fails to parse a string, it returns null and leaves the parse position unchanged. The convenience method parse(String) indicates parse failure by throwing a ParseException.

Parsing an extremely large or small absolute value (such as 1.0E10000 or 1.0E-10000) requires huge memory allocation for representing the parsed number. Such input may expose a risk of DoS attacks. To prevent huge memory allocation triggered by such inputs, DecimalFormat internally limits of maximum decimal digits to be 1000. Thus, an input string resulting more than 1000 digits in plain decimal representation (non-exponent) will be treated as either overflow (positive/negative infinite) or underflow (+0.0/-0.0).

Formatting

Formatting is guided by several parameters, all of which can be specified either using a pattern or using the API. The following description applies to formats that do not use scientific notation or significant digits.

• If the number of actual integer digits exceeds the maximum integer digits, then only the least significant digits are shown. For example, 1997 is formatted as "97" if the maximum integer digits is set to 2.
• If the number of actual integer digits is less than the minimum integer digits, then leading zeros are added. For example, 1997 is formatted as "01997" if the minimum integer digits is set to 5.
• If the number of actual fraction digits exceeds the maximum fraction digits, then half-even rounding it performed to the maximum fraction digits. For example, 0.125 is formatted as "0.12" if the maximum fraction digits is 2. This behavior can be changed by specifying a rounding increment and a rounding mode.
• If the number of actual fraction digits is less than the minimum fraction digits, then trailing zeros are added. For example, 0.125 is formatted as "0.1250" if the mimimum fraction digits is set to 4.
• Trailing fractional zeros are not displayed if they occur j positions after the decimal, where j is less than the maximum fraction digits. For example, 0.10004 is formatted as "0.1" if the maximum fraction digits is four or less.

Special Values

NaN is represented as a single character, typically \uFFFD. This character is determined by the DecimalFormatSymbols object. This is the only value for which the prefixes and suffixes are not used.

Infinity is represented as a single character, typically \u221E, with the positive or negative prefixes and suffixes applied. The infinity character is determined by the DecimalFormatSymbols object.

Scientific Notation

Numbers in scientific notation are expressed as the product of a mantissa and a power of ten, for example, 1234 can be expressed as 1.234 x 10³. The mantissa is typically in the half-open interval [1.0, 10.0) or sometimes [0.0, 1.0), but it need not be. DecimalFormat supports arbitrary mantissas. DecimalFormat can be instructed to use scientific notation through the API or through the pattern. In a pattern, the exponent character immediately followed by one or more digit characters indicates scientific notation. Example: "0.###E0" formats the number 1234 as "1.234E3".

• The number of digit characters after the exponent character gives the minimum exponent digit count. There is no maximum. Negative exponents are formatted using the localized minus sign, not the prefix and suffix from the pattern. This allows patterns such as "0.###E0 m/s". To prefix positive exponents with a localized plus sign, specify '+' between the exponent and the digits: "0.###E+0" will produce formats "1E+1", "1E+0", "1E-1", etc. (In localized patterns, use the localized plus sign rather than '+'.)
• The minimum number of integer digits is achieved by adjusting the exponent. Example: 0.00123 formatted with "00.###E0" yields "12.3E-4". This only happens if there is no maximum number of integer digits. If there is a maximum, then the minimum number of integer digits is fixed at one.
• The maximum number of integer digits, if present, specifies the exponent grouping. The most common use of this is to generate engineering notation, in which the exponent is a multiple of three, e.g., "##0.###E0". The number 12345 is formatted using "##0.####E0" as "12.345E3".
• When using scientific notation, the formatter controls the digit counts using significant digits logic. The maximum number of significant digits limits the total number of integer and fraction digits that will be shown in the mantissa; it does not affect parsing. For example, 12345 formatted with "##0.##E0" is "12.3E3". See the section on significant digits for more details.
• The number of significant digits shown is determined as follows: If areSignificantDigitsUsed() returns false, then the minimum number of significant digits shown is one, and the maximum number of significant digits shown is the sum of the minimum integer and maximum fraction digits, and is unaffected by the maximum integer digits. If this sum is zero, then all significant digits are shown. If areSignificantDigitsUsed() returns true, then the significant digit counts are specified by getMinimumSignificantDigits() and getMaximumSignificantDigits(). In this case, the number of integer digits is fixed at one, and there is no exponent grouping.
• Exponential patterns may not contain grouping separators.

Significant Digits

Pattern	Minimum significant digits	Maximum significant digits	Number	Output of format()
@@@	3	3	12345	12300
@@@	3	3	0.12345	0.123
@@##	2	4	3.14159	3.142
@@##	2	4	1.23004	1.23

• Significant digit counts may be expressed using patterns that specify a minimum and maximum number of significant digits. These are indicated by the '@' and '#' characters. The minimum number of significant digits is the number of '@' characters. The maximum number of significant digits is the number of '@' characters plus the number of '#' characters following on the right. For example, the pattern "@@@" indicates exactly 3 significant digits. The pattern "@##" indicates from 1 to 3 significant digits. Trailing zero digits to the right of the decimal separator are suppressed after the minimum number of significant digits have been shown. For example, the pattern "@##" formats the number 0.1203 as "0.12".
• If a pattern uses significant digits, it may not contain a decimal separator, nor the '0' pattern character. Patterns such as "@00" or "@.###" are disallowed.
• Any number of '#' characters may be prepended to the left of the leftmost '@' character. These have no effect on the minimum and maximum significant digits counts, but may be used to position grouping separators. For example, "#,#@#" indicates a minimum of one significant digits, a maximum of two significant digits, and a grouping size of three.
• In order to enable significant digits formatting, use a pattern containing the '@' pattern character. Alternatively, call setSignificantDigitsUsed(true).
• In order to disable significant digits formatting, use a pattern that does not contain the '@' pattern character. Alternatively, call setSignificantDigitsUsed(false).
• The number of significant digits has no effect on parsing.
• Significant digits may be used together with exponential notation. Such patterns are equivalent to a normal exponential pattern with a minimum and maximum integer digit count of one, a minimum fraction digit count of getMinimumSignificantDigits() - 1, and a maximum fraction digit count of getMaximumSignificantDigits() - 1. For example, the pattern "@@###E0" is equivalent to "0.0###E0".
• If signficant digits are in use, then the integer and fraction digit counts, as set via the API, are ignored. If significant digits are not in use, then the signficant digit counts, as set via the API, are ignored.

Padding

DecimalFormat supports padding the result of format(BigDecimal) to a specific width. Padding may be specified either through the API or through the pattern syntax. In a pattern the pad escape character, followed by a single pad character, causes padding to be parsed and formatted. The pad escape character is '*' in unlocalized patterns, and can be localized using setPadEscape(char). For example, "$*x#,##0.00" formats 123 to "$xx123.00", and 1234 to "$1,234.00".

• When padding is in effect, the width of the positive subpattern, including prefix and suffix, determines the format width. For example, in the pattern "* #0 o''clock", the format width is 10.
• The width is counted in 16-bit code units (Java chars).
• Some parameters which usually do not matter have meaning when padding is used, because the pattern width is significant with padding. In the pattern "* ##,##,#,##0.##", the format width is 14. The initial characters "##,##," do not affect the grouping size or maximum integer digits, but they do affect the format width.
• Padding may be inserted at one of four locations: before the prefix, after the prefix, before the suffix, or after the suffix. If padding is specified in any other location, applyPattern(String) throws an IllegalArgumentException. If there is no prefix, before the prefix and after the prefix are equivalent, likewise for the suffix.
• When specified in a pattern, the 16-bit char immediately following the pad escape is the pad character. This may be any character, including a special pattern character. That is, the pad escape escapes the following character. If there is no character after the pad escape, then the pattern is illegal.

Rounding

DecimalFormat supports rounding to a specific increment. For example, 1230 rounded to the nearest 50 is 1250. 1.234 rounded to the nearest 0.65 is 1.3. The rounding increment may be specified through the API or in a pattern. To specify a rounding increment in a pattern, include the increment in the pattern itself. "#,#50" specifies a rounding increment of 50. "#,##0.05" specifies a rounding increment of 0.05.

• Rounding only affects the string produced by formatting. It does not affect parsing or change any numerical values.
• A rounding mode determines how values are rounded; see the BigDecimal documentation for a description of the modes. Rounding increments specified in patterns use the default mode, ROUND_HALF_EVEN.
• Some locales use rounding in their currency formats to reflect the smallest currency denomination.
• In a pattern, digits '1' through '9' specify rounding, but otherwise behave identically to digit '0'.

Synchronization

DecimalFormat objects are not synchronized. Multiple threads should not access one formatter concurrently.

Summary

Inherited constants

From class android.icu.text.NumberFormat int 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" (CURRENCYSTYLE). int 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 CURRENCYSTYLE [icu] Constant to specify general currency style of format. int FRACTION_FIELD Field constant used to construct a FieldPosition object. int INTEGERSTYLE [icu] Constant to specify a integer number style format. int INTEGER_FIELD Field constant used to construct a FieldPosition object. int ISOCURRENCYSTYLE [icu] Constant to specify currency style of format which uses currency ISO code to represent currency, for example: "USD3.00". int NUMBERSTYLE [icu] Constant to specify normal number style of format. int PERCENTSTYLE [icu] Constant to specify a style of format to display percent. int 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 SCIENTIFICSTYLE [icu] Constant to specify a style of format to display scientific number.

Inherited methods
From class android.icu.text.NumberFormat Object clone() Overrides clone. boolean equals(Object obj) Overrides equals. abstract StringBuffer format(BigInteger number, StringBuffer toAppendTo, FieldPosition pos) [icu] Formats a BigInteger. abstract StringBuffer format(BigDecimal number, StringBuffer toAppendTo, FieldPosition pos) [icu] Formats an ICU BigDecimal. StringBuffer format(Object number, StringBuffer toAppendTo, FieldPosition pos) Formats a number and appends the resulting text to the given string buffer. final String format(BigDecimal number) Convenience method to format a BigDecimal. abstract StringBuffer format(double number, StringBuffer toAppendTo, FieldPosition pos) Specialization of format. final String format(BigInteger number) [icu] Convenience method to format a BigInteger. abstract StringBuffer format(BigDecimal number, StringBuffer toAppendTo, FieldPosition pos) [icu] Formats a BigDecimal. final String format(BigDecimal number) [icu] Convenience method to format an ICU BigDecimal. final String format(double number) Specialization of format. final String format(long number) Specialization of format. StringBuffer format(CurrencyAmount currAmt, StringBuffer toAppendTo, FieldPosition pos) [icu] Formats a CurrencyAmount. final String format(CurrencyAmount currAmt) [icu] Convenience method to format a CurrencyAmount. abstract StringBuffer format(long number, StringBuffer toAppendTo, FieldPosition pos) Specialization of format. static Locale[] getAvailableLocales() Returns the list of Locales for which NumberFormats are available. DisplayContext getContext(DisplayContext.Type type) [icu] Get the formatter's DisplayContext value for the specified DisplayContext.Type, such as CAPITALIZATION. Currency getCurrency() Returns the Currency object used to display currency amounts. static NumberFormat getCurrencyInstance(Locale inLocale) Returns a currency format for the specified locale. static NumberFormat getCurrencyInstance(ULocale inLocale) [icu] Returns a currency format for the specified locale. static final NumberFormat getCurrencyInstance() Returns a currency format for the current default FORMAT locale. static final NumberFormat getInstance() Returns the default number format for the current default FORMAT locale. static NumberFormat getInstance(Locale inLocale) Returns the default number format for the specified locale. static NumberFormat getInstance(ULocale desiredLocale, int choice) Returns a specific style number format for a specific locale. static NumberFormat getInstance(Locale inLocale, int style) [icu] Returns a specific style number format for a specific locale. static NumberFormat getInstance(ULocale inLocale) [icu] Returns the default number format for the specified locale. static final NumberFormat getInstance(int style) [icu] Returns a specific style number format for default FORMAT locale. static NumberFormat getIntegerInstance(ULocale inLocale) [icu] Returns an integer number format for the specified locale. static final NumberFormat getIntegerInstance() Returns an integer number format for the current default FORMAT locale. static NumberFormat getIntegerInstance(Locale inLocale) Returns an integer number format for the specified locale. int getMaximumFractionDigits() Returns the maximum number of digits allowed in the fraction portion of a number. int getMaximumIntegerDigits() Returns the maximum number of digits allowed in the integer portion of a number. int getMinimumFractionDigits() Returns the minimum number of digits allowed in the fraction portion of a number. int getMinimumIntegerDigits() Returns the minimum number of digits allowed in the integer portion of a number. static NumberFormat getNumberInstance(ULocale inLocale) [icu] Returns a general-purpose number format for the specified locale. static final NumberFormat getNumberInstance() Returns a general-purpose number format for the current default FORMAT locale. static NumberFormat getNumberInstance(Locale inLocale) Returns a general-purpose number format for the specified locale. static String getPattern(ULocale forLocale, int choice) Returns the pattern for the provided locale and choice. static final NumberFormat getPercentInstance() Returns a percentage format for the current default FORMAT locale. static NumberFormat getPercentInstance(Locale inLocale) Returns a percentage format for the specified locale. static NumberFormat getPercentInstance(ULocale inLocale) [icu] Returns a percentage format for the specified locale. int getRoundingMode() Returns the rounding mode used in this NumberFormat. static NumberFormat getScientificInstance(ULocale inLocale) [icu] Returns a scientific format for the specified locale. static NumberFormat getScientificInstance(Locale inLocale) [icu] Returns a scientific format for the specified locale. static final NumberFormat getScientificInstance() [icu] Returns a scientific format for the current default FORMAT locale. int hashCode() Overrides hashCode. boolean isGroupingUsed() Returns true if grouping is used in this format. boolean isParseIntegerOnly() Returns true if this format will parse numbers as integers only. boolean isParseStrict() [icu] Returns whether strict parsing is in effect. Number parse(String text) Parses text from the beginning of the given string to produce a number. abstract 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 a Double. CurrencyAmount parseCurrency(CharSequence text, ParsePosition pos) Parses text from the given string as a CurrencyAmount. final Object parseObject(String source, ParsePosition parsePosition) Parses text from a string to produce a number. void setContext(DisplayContext context) [icu] Set a particular DisplayContext value in the formatter, such as CAPITALIZATION_FOR_STANDALONE. void setCurrency(Currency theCurrency) Sets the Currency object used to display currency amounts. void setGroupingUsed(boolean newValue) Sets whether or not grouping will be used in this format. void setMaximumFractionDigits(int newValue) Sets the maximum number of digits allowed in the fraction portion of a number. void setMaximumIntegerDigits(int newValue) Sets the maximum number of digits allowed in the integer portion of a number. void setMinimumFractionDigits(int newValue) Sets the minimum number of digits allowed in the fraction portion of a number. void setMinimumIntegerDigits(int newValue) Sets the minimum number of digits allowed in the integer portion of a number. void setParseIntegerOnly(boolean value) Sets whether or not numbers should be parsed as integers only. void setParseStrict(boolean value) [icu] Sets whether strict parsing is in effect. void setRoundingMode(int roundingMode) Set the rounding mode used in this NumberFormat.
From class java.text.Format Object clone() Creates and returns a copy of this object. final String format(Object obj) Formats an object to produce a string. abstract StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos) Formats an object and appends the resulting text to a given string buffer. AttributedCharacterIterator formatToCharacterIterator(Object obj) Formats an Object producing an AttributedCharacterIterator. Object parseObject(String source) Parses text from the beginning of the given string to produce an object. abstract Object parseObject(String source, ParsePosition pos) Parses text from a string to produce an object.
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long millis, int nanos) Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed. final void wait(long millis) Causes the current thread to wait until either another thread invokes the notify() method or the notifyAll() method for this object, or a specified amount of time has elapsed. final void wait() Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object.

Constants

int PAD_AFTER_PREFIX

int PAD_AFTER_SUFFIX

int PAD_BEFORE_PREFIX

int PAD_BEFORE_SUFFIX

Public constructors

DecimalFormat ()

DecimalFormat (String pattern)

DecimalFormat (String pattern, 
                DecimalFormatSymbols symbols)

DecimalFormat (String pattern, 
                DecimalFormatSymbols symbols, 
                CurrencyPluralInfo infoInput, 
                int style)

Public methods

void applyLocalizedPattern (String pattern)

void applyPattern (String pattern)

boolean areSignificantDigitsUsed ()

Object clone ()

boolean equals (Object obj)

StringBuffer format (BigInteger number, 
                StringBuffer result, 
                FieldPosition fieldPosition)

StringBuffer format (BigDecimal number, 
                StringBuffer result, 
                FieldPosition fieldPosition)

StringBuffer format (double number, 
                StringBuffer result, 
                FieldPosition fieldPosition)

StringBuffer format (BigDecimal number, 
                StringBuffer result, 
                FieldPosition fieldPosition)

StringBuffer format (long number, 
                StringBuffer result, 
                FieldPosition fieldPosition)

AttributedCharacterIterator formatToCharacterIterator (Object obj)

CurrencyPluralInfo getCurrencyPluralInfo ()

Currency.CurrencyUsage getCurrencyUsage ()

DecimalFormatSymbols getDecimalFormatSymbols ()

int getFormatWidth ()

int getGroupingSize ()

MathContext getMathContext ()

MathContext getMathContextICU ()

int getMaximumSignificantDigits ()

byte getMinimumExponentDigits ()

int getMinimumSignificantDigits ()

int getMultiplier ()

String getNegativePrefix ()

String getNegativeSuffix ()

char getPadCharacter ()

int getPadPosition ()

int getParseMaxDigits ()

String getPositivePrefix ()

String getPositiveSuffix ()

BigDecimal getRoundingIncrement ()

int getRoundingMode ()

int getSecondaryGroupingSize ()

int hashCode ()

boolean isDecimalPatternMatchRequired ()

boolean isDecimalSeparatorAlwaysShown ()

boolean isExponentSignAlwaysShown ()

boolean isParseBigDecimal ()

boolean isScientificNotation ()

Number parse (String text, 
                ParsePosition parsePosition)

CurrencyAmount parseCurrency (CharSequence text, 
                ParsePosition pos)

void setCurrency (Currency theCurrency)

void setCurrencyPluralInfo (CurrencyPluralInfo newInfo)

void setCurrencyUsage (Currency.CurrencyUsage newUsage)

void setDecimalFormatSymbols (DecimalFormatSymbols newSymbols)

void setDecimalPatternMatchRequired (boolean value)

void setDecimalSeparatorAlwaysShown (boolean newValue)

void setExponentSignAlwaysShown (boolean expSignAlways)

void setFormatWidth (int width)

void setGroupingSize (int newValue)

void setMathContext (MathContext newValue)

void setMathContextICU (MathContext newValue)

void setMaximumFractionDigits (int newValue)

void setMaximumIntegerDigits (int newValue)

void setMaximumSignificantDigits (int max)

void setMinimumExponentDigits (byte minExpDig)

void setMinimumFractionDigits (int newValue)

void setMinimumIntegerDigits (int newValue)

void setMinimumSignificantDigits (int min)

void setMultiplier (int newValue)

void setNegativePrefix (String newValue)

void setNegativeSuffix (String newValue)

void setPadCharacter (char padChar)

void setPadPosition (int padPos)

void setParseBigDecimal (boolean value)

void setParseMaxDigits (int newValue)

void setPositivePrefix (String newValue)

void setPositiveSuffix (String newValue)

void setRoundingIncrement (BigDecimal newValue)

void setRoundingIncrement (BigDecimal newValue)

void setRoundingIncrement (double newValue)

void setRoundingMode (int roundingMode)

void setScientificNotation (boolean useScientific)

void setSecondaryGroupingSize (int newValue)

void setSignificantDigitsUsed (boolean useSignificantDigits)

String toLocalizedPattern ()

String toPattern ()