DecimalFormat

public class DecimalFormat
extends NumberFormat

DecimalFormat是格式为十进制数的NumberFormat的具体子类。 它具有多种功能，可以在任何语言环境中解析和格式化数字，包括支持西文，阿拉伯文和印度文数字。 它还支持不同类型的数字，包括整数（123），定点数（123.4），科学记数法（1.23E4），百分比（12％）和货币金额（123美元）。 所有这些都可以本地化。

为了获得NumberFormat特定区域设置，包括默认语言环境，调用一个NumberFormat的工厂的方法，例如getInstance() 。 一般来说，不要直接调用DecimalFormat构造函数，因为NumberFormat工厂方法可能会返回除DecimalFormat子类。 如果您需要自定义格式对象，请执行以下操作：

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

一个DecimalFormat包括一个模式和一组符号 。 该模式可以使用applyPattern()直接设置，或者间接使用API方法设置。 这些符号存储在一个DecimalFormatSymbols对象中。 使用NumberFormat工厂方法时，将从本地化的ResourceBundle中读取模式和符号。

Patterns

 Pattern:
         PositivePattern
         PositivePattern ; NegativePattern
 PositivePattern:
         Prefixopt Number Suffixopt
 NegativePattern:
         Prefixopt Number Suffixopt
 Prefix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Suffix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Number:
         Integer Exponentopt
         Integer . Fraction Exponentopt
 Integer:
         MinimumInteger
         #
         # Integer
         # , Integer
 MinimumInteger:
         0
         0 MinimumInteger
         0 , MinimumInteger
 Fraction:
         MinimumFractionopt OptionalFractionopt
 MinimumFraction:
         0 MinimumFractionopt
 OptionalFraction:
         # OptionalFractionopt
 Exponent:
         E MinimumExponent
 MinimumExponent:
         0 MinimumExponentopt
 

一个DecimalFormat模式包含一个正面和负面的子模式，例如， "#,##0.00;(#,##0.00)" 。 每个子模式都有一个前缀，数字部分和后缀。 负子模式是可选的; 如果不存在，则使用以局部减号为前缀的正子模式（大多数语言环境中的'-' ）用作负子模式。 也就是说，单独"0.00"就相当于"0.00;-0.00" 。 如果存在明确的负面子模式，则仅用于指定负面前缀和后缀; 数字的数量，最小的数字和其他特征都与正向模式相同。 这意味着"#,##0.0#;(#)"产生与"#,##0.0#;(#,##0.0#)"完全相同的行为。

用于无穷大，数字，千位分隔符，小数点分隔符等的前缀，后缀和各种符号可以设置为任意值，并且在格式化过程中它们将正确显示。 但是，必须注意符号和字符串不冲突，否则解析将不可靠。 例如，对于DecimalFormat.parse() ，正面和负面的前缀或后缀必须是不同的，才能区分正值和负值。 （如果它们是相同的，那么DecimalFormat将表现得好像没有指定负的子模式。）另一个例子是小数点分隔符和千位分隔符应该是不同的字符，否则解析将不可能。

分组分隔符通常用于数千个分组，但在一些国家中，分隔数以万计。 分组大小是分组字符之间的恒定数字位数，例如3为100,000,000，或4为1,0000,0000。 如果您提供具有多个分组字符的模式，则最后一个与整数末尾之间的间隔是使用的间隔。 所以"#,##,###,####" == "######,####" == "##,####,####" 。

Special Pattern Characters

模式中的许多字符都是字面上的; 它们在分析过程中被匹配并且在格式化过程中输出不变。 另一方面，特殊字符代表其他字符，字符串或类别的字符。 除非另有说明，否则必须引用它们，如果它们以文字形式出现在前缀或后缀中。

此处列出的字符用于非本地化模式。 本地化模式使用从此格式化程序的DecimalFormatSymbols对象中取得的相应字符，而这些字符将失去其特殊状态。 货币符号和报价是两个例外，它们不是本地化的。

Symbol	Location	Localized?	Meaning
0	Number	Yes	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.
;	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 value
¤ (\u00A4)	Prefix or suffix	No	Currency sign, replaced by currency symbol. If doubled, replaced by international currency symbol. 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".

Scientific Notation

科学记数法中的数字表示为尾数和幂的乘积，例如，1234可以表示为1.234×10 ^ 3。 尾数通常在1.0 <= x <10.0的范围内，但不一定是。 可以指示DecimalFormat 仅通过模式来格式化和解析科学记数法; 目前没有创建科学记数法格式的工厂方法。 在一种模式中，紧接着一个或多个数字字符的指数字符表示科学记数法。 例如： "0.###E0"将数字1234格式化为"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".
• The minimum and maximum number of integer digits are interpreted together:
  • If the maximum number of integer digits is greater than their minimum number and greater than 1, it forces the exponent to be a multiple of the maximum number of integer digits, and the minimum number of integer digits to be interpreted as 1. The most common use of this is to generate engineering notation, in which the exponent is a multiple of three, e.g., "##0.#####E0". Using this pattern, the number 12345 formats to "12.345E3", and 123456 formats to "123.456E3".
  • Otherwise, the minimum number of integer digits is achieved by adjusting the exponent. Example: 0.00123 formatted with "00.###E0" yields "12.3E-4".
• The number of significant digits in the mantissa is the sum of the minimum integer and maximum fraction digits, and is unaffected by the maximum integer digits. For example, 12345 formatted with "##0.##E0" is "12.3E3". To show all digits, set the significant digits count to zero. The number of significant digits does not affect parsing.
• Exponential patterns may not contain grouping separators.

Rounding

Digits

Special Values

NaN被格式化为字符串，通常具有单个字符\uFFFD 。 该字符串由DecimalFormatSymbols对象确定。 这是不使用前缀和后缀的唯一值。

Infinity被格式化为一个字符串，通常具有单个字符\u221E ，并且应用了正面或负面的前缀和后缀。 无穷大字符串由DecimalFormatSymbols对象确定。

负零（ "-0" ）解析为

• BigDecimal(0) if isParseBigDecimal() is true,
• Long(0) if isParseBigDecimal() is false and isParseIntegerOnly() is true,
• Double(-0.0) if both isParseBigDecimal() and isParseIntegerOnly() are false.

Synchronization

十进制格式通常不同步。 建议为每个线程创建单独的格式实例。 如果多个线程同时访问一个格式，它必须在外部同步。

Example

 // Print out a number using the localized number, integer, currency,
 // and percent format for each locale
 Locale[] locales = NumberFormat.getAvailableLocales();
 double myNumber = -1234.56;
 NumberFormat form;
 for (int j=0; j<4; ++j) {
     System.out.println("FORMAT");
     for (int i = 0; i < locales.length; ++i) {
         if (locales[i].getCountry().length() == 0) {
            continue; // Skip language-only locales
         }
         System.out.print(locales[i].getDisplayName());
         switch (j) {
         case 0:
             form = NumberFormat.getInstance(locales[i]); break;
         case 1:
             form = NumberFormat.getIntegerInstance(locales[i]); break;
         case 2:
             form = NumberFormat.getCurrencyInstance(locales[i]); break;
         default:
             form = NumberFormat.getPercentInstance(locales[i]); break;
         }
         if (form instanceof DecimalFormat) {
             System.out.print(": " + ((DecimalFormat) form).toPattern());
         }
         System.out.print(" -> " + form.format(myNumber));
         try {
             System.out.println(" -> " + form.parse(form.format(myNumber)));
         } catch (ParseException e) {}
     }
 }
 

Summary

Inherited constants
From class java.text.NumberFormat int FRACTION_FIELD 用于构造FieldPosition对象的字段常量。 int INTEGER_FIELD 用于构造FieldPosition对象的字段常量。

Inherited methods
From class java.text.NumberFormat Object clone() 覆盖可复制 boolean equals(Object obj) 覆盖等于 StringBuffer format(Object number, StringBuffer toAppendTo, FieldPosition pos) 格式化数字并将结果文本附加到给定的字符串缓冲区。 final String format(double number) 格式专业化。 abstract StringBuffer format(double number, StringBuffer toAppendTo, FieldPosition pos) 格式专业化。 final String format(long number) 格式专业化。 abstract StringBuffer format(long number, StringBuffer toAppendTo, FieldPosition pos) 格式专业化。 static Locale[] getAvailableLocales() 返回 get*Instance方法可返回本地化实例的所有语言环境的数组。 Currency getCurrency() 格式化货币值时，获取此数字格式使用的货币。 static NumberFormat getCurrencyInstance(Locale inLocale) 返回指定语言环境的货币格式。 static final NumberFormat getCurrencyInstance() 返回当前默认语言环境的货币格式。 static final NumberFormat getInstance() 返回当前默认语言环境的通用数字格式。 static NumberFormat getInstance(Locale inLocale) 返回指定语言环境的通用数字格式。 static final NumberFormat getIntegerInstance() 返回当前默认语言环境的整数数字格式。 static NumberFormat getIntegerInstance(Locale inLocale) 返回指定语言环境的整数数字格式。 int getMaximumFractionDigits() 返回数字的小数部分中允许的最大位数。 int getMaximumIntegerDigits() 返回数字整数部分允许的最大位数。 int getMinimumFractionDigits() 返回数字的小数部分中允许的最小位数。 int getMinimumIntegerDigits() 返回数字整数部分允许的最小位数。 static final NumberFormat getNumberInstance() 返回当前默认语言环境的通用数字格式。 static NumberFormat getNumberInstance(Locale inLocale) 返回指定语言环境的通用数字格式。 static NumberFormat getPercentInstance(Locale inLocale) 返回指定语言环境的百分比格式。 static final NumberFormat getPercentInstance() 返回当前默认语言环境的百分比格式。 RoundingMode getRoundingMode() 获取此NumberFormat中使用的 RoundingMode 。 int hashCode() 重写hashCode boolean isGroupingUsed() 如果以此格式使用分组，则返回true。 boolean isParseIntegerOnly() 如果此格式仅将数字解析为整数，则返回true。 Number parse(String source) 从给定字符串的开头解析文本以产生一个数字。 abstract Number parse(String source, ParsePosition parsePosition) 如果可能的话返回一个Long（例如，在[Long.MIN_VALUE，Long.MAX_VALUE]范围内且没有小数），否则返回Double。 final Object parseObject(String source, ParsePosition pos) 解析字符串中的文本以生成 Number 。 void setCurrency(Currency currency) 格式化货币值时，设置此数字格式使用的货币。 void setGroupingUsed(boolean newValue) 设置是否以此格式使用分组。 void setMaximumFractionDigits(int newValue) 设置数字的小数部分允许的最大位数。 void setMaximumIntegerDigits(int newValue) 设置数字整数部分允许的最大位数。 void setMinimumFractionDigits(int newValue) 设置数字的小数部分中允许的最小位数。 void setMinimumIntegerDigits(int newValue) 设置数字整数部分允许的最小位数。 void setParseIntegerOnly(boolean value) 设置数字是否应该仅被解析为整数。 void setRoundingMode(RoundingMode roundingMode) 设置此NumberFormat中使用的 RoundingMode 。
From class java.text.Format Object clone() 创建并返回此对象的副本。 final String format(Object obj) 格式化一个对象来产生一个字符串。 abstract StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos) 格式化对象并将结果文本附加到给定的字符串缓冲区。 AttributedCharacterIterator formatToCharacterIterator(Object obj) 格式化产生 AttributedCharacterIterator的对象。 Object parseObject(String source) 从给定字符串的开头解析文本以生成一个对象。 abstract Object parseObject(String source, ParsePosition pos) 分析字符串中的文本以生成对象。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

DecimalFormat ()

DecimalFormat (String pattern)

DecimalFormat (String pattern, 
                DecimalFormatSymbols symbols)

Public methods

void applyLocalizedPattern (String pattern)

void applyPattern (String pattern)

Object clone ()

boolean equals (Object obj)

StringBuffer format (Object number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

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

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

AttributedCharacterIterator formatToCharacterIterator (Object obj)

Currency getCurrency ()

DecimalFormatSymbols getDecimalFormatSymbols ()

int getGroupingSize ()

int getMaximumFractionDigits ()

int getMaximumIntegerDigits ()

int getMinimumFractionDigits ()

int getMinimumIntegerDigits ()

int getMultiplier ()

String getNegativePrefix ()

String getNegativeSuffix ()

String getPositivePrefix ()

String getPositiveSuffix ()

RoundingMode getRoundingMode ()

int hashCode ()

boolean isDecimalSeparatorAlwaysShown ()

boolean isGroupingUsed ()

boolean isParseBigDecimal ()

boolean isParseIntegerOnly ()

Number parse (String text, 
                ParsePosition pos)

void setCurrency (Currency currency)

void setDecimalFormatSymbols (DecimalFormatSymbols newSymbols)

void setDecimalSeparatorAlwaysShown (boolean newValue)

void setGroupingSize (int newValue)

void setGroupingUsed (boolean newValue)

void setMaximumFractionDigits (int newValue)

void setMaximumIntegerDigits (int newValue)

void setMinimumFractionDigits (int newValue)

void setMinimumIntegerDigits (int newValue)

void setMultiplier (int newValue)

void setNegativePrefix (String newValue)

void setNegativeSuffix (String newValue)

void setParseBigDecimal (boolean newValue)

void setParseIntegerOnly (boolean value)

void setPositivePrefix (String newValue)

void setPositiveSuffix (String newValue)

void setRoundingMode (RoundingMode roundingMode)

String toLocalizedPattern ()

String toPattern ()