DecimalFormat (Java Platform SE 8 )

java.lang.Object
- java.text.Format
- - java.text.NumberFormat
  - - java.text.DecimalFormat

All Implemented Interfaces:: Serializable， Cloneable

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工厂方法模式和符号是从局部ResourceBundles读。

模式

DecimalFormat模式具有以下语法：

 Pattern:
         PositivePattern
         PositivePattern ; NegativePattern
 PositivePattern:
         Prefix_opt Number Suffix_opt
 NegativePattern:
         Prefix_opt Number Suffix_opt
 Prefix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Suffix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Number:
         Integer Exponent_opt
         Integer . Fraction Exponent_opt
 Integer:
         MinimumInteger
         #
         # Integer
         # , Integer
 MinimumInteger:
         0
         0 MinimumInteger
         0 , MinimumInteger
 Fraction:
         MinimumFraction_opt OptionalFraction_opt
 MinimumFraction:
         0 MinimumFraction_opt
 OptionalFraction:
         # OptionalFraction_opt
 Exponent:
         E MinimumExponent
 MinimumExponent:
         0 MinimumExponent_opt

一个DecimalFormat模式包含了正面和负面的模式，例如，"#,##0.00;(#,##0.00)"。每个子模式有一个前缀，后缀的数字部分。负子模式是可选的；如果没有，那么积极的模式以本地化的减号（'-'在大多数地区）作为子模式。这是"0.00"仅相当于"0.00;-0.00"。如果有一个明确的负面模式，它只会指定否定前缀和后缀；数字、数量及其他特点的最小位数，均为正面图案相同。这意味着，"#,##0.0#;(#)"产生完全相同的行为"#,##0.0#;(#,##0.0#)"。

前缀，后缀，及各种符号用于无限位数，千位分隔符、小数点分隔符等，可以设置为任意值，它们将出现在格式正确。然而，必须注意的是，符号和字符串不冲突，或分析将是不可靠的。例如，无论是正面和负面的前缀或后缀必须为DecimalFormat.parse()能够区分正负值不同。（如果他们是相同的，那么DecimalFormat表现得如指定。不负子模式）另一个例子是小数点分隔符和千位分隔符应鲜明，或分析将是不可能的。

分组分离器通常用于成千上万，但在一些国家，它分离了十个。分组大小是分组字符之间的一个常数数，如3为100000000或100000000为4。如果您提供了一个具有多个分组字符的模式，则在最后一个整数的最后一个和整数的结束之间的间隔是使用的一个。所以"#,##,###,####" = = = = "##,####,####" "######,####"。

特殊的模式特征

在一个模式中的许多字符都是字面上的，它们在分析和输出过程中的匹配过程中保持不变，在格式。另一方面，特殊字符，支持其他字符、字符串或字符类。他们必须引用，除非另有说明，如果他们出现在前缀或后缀的文字。

这里列出的字符用于非局部模式。本地化模式使用从这个格式化的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".

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"`.

科学记数法

在科学记数法表示为一个数字的尾数和十的幂，该产品为例，1234可以表示为1.234×10 ^ 3。尾数往往是在范围1≤x＜10，但它不需要。DecimalFormat可以指示格式和解析科学记数法只能通过一个模式；目前没有工厂方法创建一个科学记数法格式。在一个模式中，紧随其后的一个或多个数字字符的指数字符表示科学符号。例如："0.###E0"格式的人数1234 "1.234E3"。

指数字符后的数字字符数，给出了最小的指数数字计数。没有最大值。负指数是使用本地化的减符号来格式化的，而不是来自模式的前缀和后缀。这使得图案如"0.###E0 m/s"。
最小和最大数量的整数位数解释道：
- 如果整数数字的最大数目大于它们的最小值和大于1，它迫使指数是整数数字的最大数的倍数，和整数数字的最小数目被解释为1。最常见的用途是产生工程符号，其中指数是三，多如"##0.#####E0"。使用这种模式，数字12345格式和123456格式"123.456E3" "12.345E3"。
- 否则，通过调整指数来实现整数位数的最小值。例如：0.00123格式的"00.###E0"产量"12.3E-4"。
在尾数的有效数字的位数是最小的整数和小数部分之和最大，是不受的最大整数位数。例如，12345格式的"##0.##E0"是"12.3E3"。显示所有数字，设置有效位数为零。重要数字的个数不影响分析。
指数模式可能不包含分组分隔符。

舍入

DecimalFormat提供RO周在 RoundingMode格式化模式定义。默认情况下，它使用 RoundingMode.HALF_EVEN。

数字

格式化， DecimalFormat使用十个连续的字符开始与局部零位定义在 DecimalFormatSymbols对象作为数字。解析，这些数字以及所有的Unicode码的十进制数字，所定义的 Character.digit，确认。

特殊值

NaN格式化为一个字符串，它通常有一个单独的字符\uFFFD。这个字符串是由DecimalFormatSymbols对象确定。这是唯一值的前缀和后缀都没有用。

无限是格式化为一个字符串，它通常有一个单独的字符\u221E，与正面或负面的前缀和后缀的应用。无穷大的字符串是由DecimalFormatSymbols对象确定。

负零（"-0"）解析

如果是真的BigDecimal(0) isParseBigDecimal()，
Long(0)如果isParseBigDecimal()是错误的，isParseIntegerOnly()是真实的，
Double(-0.0)如果isParseBigDecimal()和isParseIntegerOnly()是假的。

Synchronization

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

例子


 <strong>// Print out a number using the localized number, integer, currency,
 // and percent format for each locale</strong>
 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) {}
     }
 }

另请参见：: Java Tutorial， NumberFormat， DecimalFormatSymbols， ParsePosition， Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class java.text.NumberFormat
  NumberFormat.Field

Field Summary
- Fields inherited from class java.text.NumberFormat
  FRACTION_FIELD, INTEGER_FIELD

构造方法摘要

构造方法
Constructor and Description
`DecimalFormat()` 创建一个使用默认 `FORMAT` DecimalFormat现场默认图案和符号。
`DecimalFormat(String pattern)` 创建一个DecimalFormat使用给定的类型和默认 `FORMAT`现场符号。
`DecimalFormat(String pattern, DecimalFormatSymbols symbols)` 创建一个使用给定的图案和符号DecimalFormat。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`applyLocalizedPattern(String pattern)` 将给定的模式应用到这个格式对象。
`void`	`applyPattern(String pattern)` 将给定的模式应用到这个格式对象。
`Object`	`clone()` 标准重写；语义没有更改。
`boolean`	`equals(Object obj)` 重写equals
`StringBuffer`	`format(double number, StringBuffer result, FieldPosition fieldPosition)` 格式化一个双产生一个字符串。
`StringBuffer`	`format(long number, StringBuffer result, FieldPosition fieldPosition)` 格式很长，产生一个字符串。
`StringBuffer`	`format(Object number, StringBuffer toAppendTo, FieldPosition pos)` 格式的数量和将产生的文本的字符串缓冲区。
`AttributedCharacterIterator`	`formatToCharacterIterator(Object obj)` 格式对象产生一个 `AttributedCharacterIterator`。
`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()` 被采用的 `RoundingMode` DecimalFormat。
`int`	`hashCode()` 重写hashCode
`boolean`	`isDecimalSeparatorAlwaysShown()` 允许您获取整数的十进制分隔符的行为。
`boolean`	`isParseBigDecimal()` 返回是否 `parse(java.lang.String, java.text.ParsePosition)`方法返回 `BigDecimal`。
`Number`	`parse(String text, ParsePosition pos)` 解析文本字符串以产生 `Number`。
`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)` 设置是否 `parse(java.lang.String, java.text.ParsePosition)`方法返回 `BigDecimal`。
`void`	`setPositivePrefix(String newValue)` 设置前缀。
`void`	`setPositiveSuffix(String newValue)` 设置积极的后缀。
`void`	`setRoundingMode(RoundingMode roundingMode)` 集在这的 `RoundingMode` DecimalFormat。
`String`	`toLocalizedPattern()` 合成表示此格式对象的当前状态的局部模式字符串。
`String`	`toPattern()` 合成表示此格式对象的当前状态的模式字符串。

Methods inherited from class java.text.NumberFormat
format, format, getAvailableLocales, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setParseIntegerOnly

Methods inherited from class java.text.Format
format, parseObject

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DecimalFormat
```
public DecimalFormat()
```
    创建一个使用默认 FORMAT DecimalFormat现场默认图案和符号。这是一个方便的方式来获得一个DecimalFormat当国际化不是主要关心的。
    获得的标准格式，对于一个给定的区域，使用工厂方法如getnumberinstance解析。这些工厂将返回给定现场解析最合适的子类。
    
    另请参见：
    
    NumberFormat.getInstance()， NumberFormat.getNumberInstance()， NumberFormat.getCurrencyInstance()， NumberFormat.getPercentInstance()
  - DecimalFormat
```
public DecimalFormat(String pattern)
```
    创建一个DecimalFormat使用给定的类型和默认 FORMAT现场符号。这是一个方便的方式来获得一个DecimalFormat当国际化不是主要关心的。
    获得的标准格式，对于一个给定的区域，使用工厂方法如getnumberinstance解析。这些工厂将返回给定现场解析最合适的子类。
    
    参数
    
    pattern -非本地化的字符串。
    
    异常
    
    NullPointerException -如果 pattern是空的
    
    IllegalArgumentException如果给定的模式是无效的。
    
    另请参见：
    
    NumberFormat.getInstance()， NumberFormat.getNumberInstance()， NumberFormat.getCurrencyInstance()， NumberFormat.getPercentInstance()
  - DecimalFormat
```
public DecimalFormat(String pattern,
                     DecimalFormatSymbols symbols)
```
    创建一个使用给定的图案和符号DecimalFormat。当您需要完全自定义格式的行为时，使用此构造函数。
    获得的标准格式，对于一个给定的区域，使用工厂方法如getInstance或getcurrencyinstance解析。如果你只需要轻微调整到一个标准的格式，你可以修改的格式解析工厂方法返回。
    
    参数
    
    pattern -非本地化的字符串
    
    symbols -使用的符号集
    
    异常
    
    NullPointerException -如果任何给定的参数为空
    
    IllegalArgumentException如果给定的模式是无效的
    
    另请参见：
    
    NumberFormat.getInstance()， NumberFormat.getNumberInstance()， NumberFormat.getCurrencyInstance()， NumberFormat.getPercentInstance()， DecimalFormatSymbols
- 方法详细信息
  - format
```
public final StringBuffer format(Object number,
                                 StringBuffer toAppendTo,
                                 FieldPosition pos)
```
    格式的数量和将产生的文本的字符串缓冲区。数可以是任何类 Number。
    此实现使用允许的最大精度。
    
    重写：
    
    format 方法重写，继承类 NumberFormat
    
    参数
    
    number的数字格式
    
    toAppendTo - StringBuffer，格式化的文本要附加
    
    pos -输入：校准领域，如果需要的话。输出：对准场的偏移量。
    
    结果
    
    通过在 toAppendTo价值
    
    异常
    
    IllegalArgumentException -如果 number是无效的或不 Number实例。
    
    NullPointerException -如果 toAppendTo或 pos是空的
    
    ArithmeticException如果取整舍入模式被设置为roundingmode.unnecessary需要
    
    另请参见：
    
    FieldPosition
  - format
```
public StringBuffer format(double number,
                           StringBuffer result,
                           FieldPosition fieldPosition)
```
    格式化一个双产生一个字符串。
    
    Specified by:
    
    format 方法重写，继承类 NumberFormat
    
    参数
    
    number -格式的双
    
    result，文本是要追加
    
    fieldPosition -输入：校准领域，如果需要的话。输出：对准场的偏移量。
    
    结果
    
    格式化的数字字符串
    
    异常
    
    ArithmeticException如果取整舍入模式被设置为roundingmode.unnecessary需要
    
    另请参见：
    
    FieldPosition
  - format
```
public StringBuffer format(long number,
                           StringBuffer result,
                           FieldPosition fieldPosition)
```
    格式很长，产生一个字符串。
    
    Specified by:
    
    format 方法重写，继承类 NumberFormat
    
    参数
    
    number -格式的长
    
    result，文本是要追加
    
    fieldPosition -输入：校准领域，如果需要的话。输出：对准场的偏移量。
    
    结果
    
    格式化的数字字符串
    
    异常
    
    ArithmeticException如果取整舍入模式被设置为roundingmode.unnecessary需要
    
    另请参见：
    
    FieldPosition
  - formatToCharacterIterator
```
public AttributedCharacterIterator formatToCharacterIterator(Object obj)
```
    格式对象产生一个 AttributedCharacterIterator。你可以使用返回的 AttributedCharacterIterator建立得到的字符串，以及确定得到的字符串信息。
    attributedcharacteriterator每个属性的关键将是NumberFormat.Field型，与属性值作为属性的关键一样。
    
    重写：
    
    formatToCharacterIterator 方法重写，继承类 Format
    
    参数
    
    obj -格式化对象
    
    结果
    
    attributedcharacteriterator描述格式化值。
    
    异常
    
    NullPointerException如果obj是空的。
    
    IllegalArgumentException当格式不格式给定的对象。
    
    ArithmeticException如果取整舍入模式被设置为roundingmode.unnecessary需要
    
    从以下版本开始：
    
    一点四
  - parse
```
public Number parse(String text,
                    ParsePosition pos)
```
    解析文本字符串以产生 Number。
    解析文本开始了pos索引的方法尝试。如果分析成功，那么pos索引更新索引的最后一个字符后（解析不一定使用所有字符到字符串的末尾），和解析数返回。更新pos可以用来指示下一个调用这个方法的出发点。如果出现错误，那么pos指标没有发生变化，对pos误差指标设置为错误发生位置的字符的索引，并返回null。
    
    子类的返回值取决于isParseBigDecimal()以及字符串解析。
    - 如果isParseBigDecimal()是错误的（默认），大多数的整数值作为Long返回的对象，无论他们是如何写的："17"和"17.000"都Long(17)解析。价值观融入一个Long不能返回Doubles。这包括价值观与小数部分，无限的价值，NaN，和价值0。DecimalFormat不决定是否返回一个Double或Long基于源字符串中小数点分隔符的存在。这样做可以防止整数溢出的双尾数，如"-9,223,372,036,854,775,808.00"，从解析的准确。
      用户可以使用Number方法doubleValue，longValue，等，获得他们想要的类型。
    - 如果isParseBigDecimal()是真实的，是BigDecimal对象返回值。该值是由在现场独立的格式字符串BigDecimal.BigDecimal(String)构建相应的。特殊情况下，正、负无穷大和楠是Double实例持有对应Double常数的值。
    DecimalFormat解析所有Unicode字符表示的十进制数字，所定义的Character.digit()。此外，DecimalFormat也识别为数字的十个连续的字符开始在DecimalFormatSymbols对象定义的局部零位。
    Specified by:
    
    parse 方法重写，继承类 NumberFormat
    
    参数
    
    text -被解析的字符串
    
    pos -一个指标和误差指标上述信息， ParsePosition对象。
    
    结果
    
    解析值，或 null如果解析失败
    
    异常
    
    NullPointerException -如果 text或 pos是空的。
    
    另请参见：
    
    NumberFormat.isParseIntegerOnly()， Format.parseObject(java.lang.String, java.text.ParsePosition)
  - getDecimalFormatSymbols
```
public DecimalFormatSymbols getDecimalFormatSymbols()
```
    返回一个十进制格式符号的副本，这通常不会由程序员或用户更改。
    
    结果
    
    一份理想的decimalformatsymbols
    
    另请参见：
    
    DecimalFormatSymbols
  - setDecimalFormatSymbols
```
public void setDecimalFormatSymbols(DecimalFormatSymbols newSymbols)
```
    设置十进制格式符号，一般不由程序员或用户更改。
    
    参数
    
    newSymbols -所需的decimalformatsymbols
    
    另请参见：
    
    DecimalFormatSymbols
  - getPositivePrefix
```
public String getPositivePrefix()
```
    获得积极的前缀。
    例子：+ 123，123美元，sfr123
    
    结果
    
    积极的前缀
  - setPositivePrefix
```
public void setPositivePrefix(String newValue)
```
    设置前缀。
    例子：+ 123，123美元，sfr123
    
    参数
    
    newValue -新的积极的前缀
  - getNegativePrefix
```
public String getNegativePrefix()
```
    得到否定前缀。
    例：123、（123美元）（阴性后缀），sfr-123
    
    结果
    
    否定前缀
  - setNegativePrefix
```
public void setNegativePrefix(String newValue)
```
    设置负前缀。
    例：123、（123美元）（阴性后缀），sfr-123
    
    参数
    
    newValue -新的否定前缀
  - getPositiveSuffix
```
public String getPositiveSuffix()
```
    得到积极的后缀。
    例如：123%
    
    结果
    
    阳性后缀
  - setPositiveSuffix
```
public void setPositiveSuffix(String newValue)
```
    设置积极的后缀。
    例如：123%
    
    参数
    
    newValue -新的阳性后缀
  - getNegativeSuffix
```
public String getNegativeSuffix()
```
    得到负后缀。
    例：123%、（123美元）（阳性后缀）
    
    结果
    
    阴性后缀
  - setNegativeSuffix
```
public void setNegativeSuffix(String newValue)
```
    设置负后缀。
    例子：123%
    
    参数
    
    newValue -新的阴性后缀
  - getMultiplier
```
public int getMultiplier()
```
    得到的乘数使用%，‰，和类似的格式。
    
    结果
    
    乘数
    
    另请参见：
    
    setMultiplier(int)
  - setMultiplier
```
public void setMultiplier(int newValue)
```
    设置使用百分比，乘数每千，和类似的格式。百分之一格式，设置乘数100和后缀有“%”（阿拉伯语，使用阿拉伯百分号）。一‰的格式，设置乘数1000和有“后缀”\ u2030。
    例如：乘法器100，1.23被格式化为“123”，“123”被解析为1.23个。
    
    参数
    
    newValue -新的乘数
    
    另请参见：
    
    getMultiplier()
  - setGroupingUsed
```
public void setGroupingUsed(boolean newValue)
```
    设置是否将使用此格式。
    
    重写：
    
    setGroupingUsed 方法重写，继承类 NumberFormat
    
    参数
    
    newValue - true如果分组使用； false否则
    
    另请参见：
    
    NumberFormat.isGroupingUsed()
  - getGroupingSize
```
public int getGroupingSize()
```
    返回分组大小。分组大小是在数字的整数部分的分组分隔符之间的数字的数目。例如，在“123456.78”的数字“”中，分组大小为3。
    
    结果
    
    分组大小
    
    另请参见：
    
    setGroupingSize(int)， NumberFormat.isGroupingUsed()， DecimalFormatSymbols.getGroupingSeparator()
  - setGroupingSize
```
public void setGroupingSize(int newValue)
```
    设置分组大小。分组大小是在数字的整数部分的分组分隔符之间的数字的数目。例如，在“123456.78”的数字“”中，分组大小为3。
    值通过转换为一个字节，这可能会丢失信息。
    
    参数
    
    newValue -新的分组大小
    
    另请参见：
    
    getGroupingSize()， NumberFormat.setGroupingUsed(boolean)， DecimalFormatSymbols.setGroupingSeparator(char)
  - isDecimalSeparatorAlwaysShown
```
public boolean isDecimalSeparatorAlwaysShown()
```
    允许您获取整数的十进制分隔符的行为。（小数点分隔符会出现
    例如：十进制：12345→12345；：12345→12345
    小数。）
    
    结果
    
    true如果小数点分隔符总表现； false否则
  - setDecimalSeparatorAlwaysShown
```
public void setDecimalSeparatorAlwaysShown(boolean newValue)
```
    允许您设置整数的十进制分隔符的行为。（小数点分隔符会出现
    例如：十进制：12345→12345；：12345→12345
    小数。）
    
    参数
    
    newValue - true如果小数点分隔符总表现； false否则
  - isParseBigDecimal
```
public boolean isParseBigDecimal()
```
    返回是否 parse(java.lang.String, java.text.ParsePosition)方法返回 BigDecimal。默认值是错误的。
    
    结果
    
    true如果解析方法返回BigDecimal； false否则
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    setParseBigDecimal(boolean)
  - setParseBigDecimal
```
public void setParseBigDecimal(boolean newValue)
```
    设置是否 parse(java.lang.String, java.text.ParsePosition)方法返回 BigDecimal。
    
    参数
    
    newValue - true如果解析方法返回BigDecimal； false否则
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    isParseBigDecimal()
  - clone
```
public Object clone()
```
    标准重写；语义没有更改。
    
    重写：
    
    clone 方法重写，继承类 NumberFormat
    
    结果
    
    这个实例的克隆。
    
    另请参见：
    
    Cloneable
  - equals
```
public boolean equals(Object obj)
```
    重写equals
    
    重写：
    
    equals 方法重写，继承类 NumberFormat
    
    参数
    
    obj -参考对象的比较。
    
    结果
    
    如果这个对象是 true obj参数相同； false否则。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    重写hashCode
    
    重写：
    
    hashCode 方法重写，继承类 NumberFormat
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - toPattern
```
public String toPattern()
```
    合成表示此格式对象的当前状态的模式字符串。
    
    结果
    
    一个模式串
    
    另请参见：
    
    applyPattern(java.lang.String)
  - toLocalizedPattern
```
public String toLocalizedPattern()
```
    合成表示此格式对象的当前状态的局部模式字符串。
    
    结果
    
    局部模式字符串
    
    另请参见：
    
    applyPattern(java.lang.String)
  - applyPattern
```
public void applyPattern(String pattern)
```
    将给定的模式应用到这个格式对象。模式是一个短手规范的各种格式属性。这些属性也可以通过各种各样的setter方法单独改变。
    有整数位数设置这个程序没有限制，因为这是典型的最终用户的愿望；如果你想建立一个真正的利用价值setmaximuminteger。对于负数，使用第二图案，用分号隔开
    
    例1234.56 "#,#00.0#"→
    
    这意味着一个最小的2个整数数字，1个小数位数，和最大的2个小数位数。
    
    例如：在括号中"#,#00.0#;(#,#00.0#)"底片。
    
    在负模式中，最小和最大计数被忽略，这些被假定为被设置在正模式。
    
    参数
    
    pattern -一个新的模式
    
    异常
    
    NullPointerException -如果 pattern是空的
    
    IllegalArgumentException如果给定的模式是无效的。
  - applyLocalizedPattern
```
public void applyLocalizedPattern(String pattern)
```
    将给定的模式应用到这个格式对象。该模式被假定为在一个本地化的符号。模式是一个短手规范的各种格式属性。这些属性也可以通过各种各样的setter方法单独改变。
    有整数位数设置这个程序没有限制，因为这是典型的最终用户的愿望；如果你想建立一个真正的利用价值setmaximuminteger。对于负数，使用第二图案，用分号隔开
    
    例1234.56 "#,#00.0#"→
    
    这意味着一个最小的2个整数数字，1个小数位数，和最大的2个小数位数。
    
    例如：在括号中"#,#00.0#;(#,#00.0#)"底片。
    
    在负模式中，最小和最大计数被忽略，这些被假定为被设置在正模式。
    
    参数
    
    pattern -一个新的模式
    
    异常
    
    NullPointerException -如果 pattern是空的
    
    IllegalArgumentException如果给定的模式是无效的。
  - setMaximumIntegerDigits
```
public void setMaximumIntegerDigits(int newValue)
```
    设置整数部分中允许的数字的最大数量。用于格式化数字比其他 BigInteger和 BigDecimal对象，对 newValue下和309使用。负输入值被替换为0。
    
    重写：
    
    setMaximumIntegerDigits 方法重写，继承类 NumberFormat
    
    参数
    
    newValue -整数的最大位数被显示；如果小于零，则为零作为。具体的子类可以强制执行该值的上限，该值适用于格式化的数字类型。
    
    另请参见：
    
    NumberFormat.setMaximumIntegerDigits(int)
  - setMinimumIntegerDigits
```
public void setMinimumIntegerDigits(int newValue)
```
    设置在数字的整数部分中允许的最小数字。用于格式化数字比其他 BigInteger和 BigDecimal对象，对 newValue下和309使用。负输入值被替换为0。
    
    重写：
    
    setMinimumIntegerDigits 方法重写，继承类 NumberFormat
    
    参数
    
    newValue -整数的最小位数显示；如果小于零，则为零作为。具体的子类可以强制执行该值的上限，该值适用于格式化的数字类型。
    
    另请参见：
    
    NumberFormat.setMinimumIntegerDigits(int)
  - setMaximumFractionDigits
```
public void setMaximumFractionDigits(int newValue)
```
    设置数字的小数部分中允许的最大数字。用于格式化数字比其他 BigInteger和 BigDecimal对象，对 newValue下和340使用。负输入值被替换为0。
    
    重写：
    
    setMaximumFractionDigits 方法重写，继承类 NumberFormat
    
    参数
    
    newValue -分数的最大位数被显示；如果小于零，则为零作为。具体的子类可以强制执行该值的上限，该值适用于格式化的数字类型。
    
    另请参见：
    
    NumberFormat.setMaximumFractionDigits(int)
  - setMinimumFractionDigits
```
public void setMinimumFractionDigits(int newValue)
```
    设置一个数字的小数部分中允许的最小数字。用于格式化数字比其他 BigInteger和 BigDecimal对象，对 newValue下和340使用。负输入值被替换为0。
    
    重写：
    
    setMinimumFractionDigits 方法重写，继承类 NumberFormat
    
    参数
    
    newValue -分位数将显示最小值；如果小于零，则为零作为。具体的子类可以强制执行该值的上限，该值适用于格式化的数字类型。
    
    另请参见：
    
    NumberFormat.setMinimumFractionDigits(int)
  - getMaximumIntegerDigits
```
public int getMaximumIntegerDigits()
```
    获取数字的整数部分中允许的数字的最大数目。用于格式化数字比其他 BigInteger和 BigDecimal对象，返回值的降低，309是用。
    
    重写：
    
    getMaximumIntegerDigits 方法重写，继承类 NumberFormat
    
    结果
    
    数字的最大数
    
    另请参见：
    
    setMaximumIntegerDigits(int)
  - getMinimumIntegerDigits
```
public int getMinimumIntegerDigits()
```
    获取数字的整数部分中允许的最小数字。用于格式化数字比其他 BigInteger和 BigDecimal对象，返回值的降低，309是用。
    
    重写：
    
    getMinimumIntegerDigits 方法重写，继承类 NumberFormat
    
    结果
    
    最小数字位数
    
    另请参见：
    
    setMinimumIntegerDigits(int)
  - getMaximumFractionDigits
```
public int getMaximumFractionDigits()
```
    获取数字的小数部分中允许的最大数字。用于格式化数字比其他 BigInteger和 BigDecimal对象，返回值的降低，340是用。
    
    重写：
    
    getMaximumFractionDigits 方法重写，继承类 NumberFormat
    
    结果
    
    数字的最大数。
    
    另请参见：
    
    setMaximumFractionDigits(int)
  - getMinimumFractionDigits
```
public int getMinimumFractionDigits()
```
    获取数字的小数部分中允许的最小数字。用于格式化数字比其他 BigInteger和 BigDecimal对象，返回值的降低，340是用。
    
    重写：
    
    getMinimumFractionDigits 方法重写，继承类 NumberFormat
    
    结果
    
    最小数字位数
    
    另请参见：
    
    setMinimumFractionDigits(int)
  - getCurrency
```
public Currency getCurrency()
```
    使用此十进制格式格式化货币值时所使用的货币。货币是由这个数字格式的符号称 DecimalFormatSymbols.getCurrency获得。
    
    重写：
    
    getCurrency 方法重写，继承类 NumberFormat
    
    结果
    
    这个十进制格式使用的货币，或 null
    
    从以下版本开始：
    
    一点四
  - setCurrency
```
public void setCurrency(Currency currency)
```
    设置格式化货币值时此数字格式所使用的货币。这不更新数字格式所使用的小数位数的最小值或最大值。货币是由这个数字格式的符号称 DecimalFormatSymbols.setCurrency。
    
    重写：
    
    setCurrency 方法重写，继承类 NumberFormat
    
    参数
    
    currency -是由十进制格式使用新的货币
    
    异常
    
    NullPointerException -如果 currency是空的
    
    从以下版本开始：
    
    一点四
  - getRoundingMode
```
public RoundingMode getRoundingMode()
```
    被采用的 RoundingMode DecimalFormat。
    
    重写：
    
    getRoundingMode 方法重写，继承类 NumberFormat
    
    结果
    
    用于此的 RoundingMode DecimalFormat。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    setRoundingMode(RoundingMode)
  - setRoundingMode
```
public void setRoundingMode(RoundingMode roundingMode)
```
    集在这的 RoundingMode DecimalFormat。
    
    重写：
    
    setRoundingMode 方法重写，继承类 NumberFormat
    
    参数
    
    roundingMode - RoundingMode用于
    
    异常
    
    NullPointerException -如果 roundingMode是空的。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    getRoundingMode()

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DecimalFormat

模式

特殊的模式特征

科学记数法

舍入

数字

特殊值

Synchronization

例子

Nested Class Summary

Nested classes/interfaces inherited from class java.text.NumberFormat

Field Summary

Fields inherited from class java.text.NumberFormat

构造方法摘要

方法摘要

Methods inherited from class java.text.NumberFormat

Methods inherited from class java.text.Format

Methods inherited from class java.lang.Object

Constructor Detail

DecimalFormat

DecimalFormat

DecimalFormat

方法详细信息

format

format

format

formatToCharacterIterator

parse

getDecimalFormatSymbols

setDecimalFormatSymbols

getPositivePrefix

setPositivePrefix

getNegativePrefix

setNegativePrefix

getPositiveSuffix

setPositiveSuffix

getNegativeSuffix

setNegativeSuffix

getMultiplier

setMultiplier

setGroupingUsed

getGroupingSize

setGroupingSize

isDecimalSeparatorAlwaysShown

setDecimalSeparatorAlwaysShown

isParseBigDecimal

setParseBigDecimal

clone

equals

hashCode

toPattern

toLocalizedPattern

applyPattern

applyLocalizedPattern

setMaximumIntegerDigits

setMinimumIntegerDigits

setMaximumFractionDigits

setMinimumFractionDigits

getMaximumIntegerDigits

getMinimumIntegerDigits

getMaximumFractionDigits

getMinimumFractionDigits

getCurrency

setCurrency

getRoundingMode

setRoundingMode