Most visited

Recently visited

Results for

Added in API level 24
Summary: Nested Classes | Constants | Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

NumberFormat

public abstract class NumberFormat
extends UFormat

java.lang.Object
   ↳ java.text.Format
     ↳ android.icu.text.UFormat
       ↳ android.icu.text.NumberFormat
Known Direct Subclasses
Known Indirect Subclasses

[icu增强] ICU更换为NumberFormat 。 ICU特有的方法，字段和其他功能标记为“ [icu] ”。 NumberFormat是所有数字格式的抽象基类。 这个类提供了格式和解析数字的接口。 NumberFormat还提供了确定哪些语言环境具有数字格式以及它们的名称是什么的方法。 NumberFormat可帮助您为任何区域设置格式和解析数字。 您的代码可以完全独立于小数点，千位分隔符甚至所用的特定小数位的区域设置约定，或者数字格式是否为十进制。

要为当前语言环境设置一个数字格式，请使用其中一个工厂类方法：

  myString = NumberFormat.getInstance().format(myNumber);
If you are formatting multiple numbers, it is more efficient to get the format and use it multiple times so that the system doesn't have to fetch the information about the local language and country conventions multiple times. 
 NumberFormat nf = NumberFormat.getInstance();
 for (int i = 0; i < a.length; ++i) {
     output.println(nf.format(myNumber[i]) + "; ");
 }
To format a number for a different Locale, specify it in the call to getInstance. 
 NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
You can also use a NumberFormat to parse numbers: 
 myNumber = nf.parse(myString);
Use getInstance or getNumberInstance to get the normal number format. Use getIntegerInstance to get an integer number format. Use getCurrencyInstance to get the currency number format. And use getPercentInstance to get a format for displaying percentages. Some factory methods are found within subclasses of NumberFormat. With this format, a fraction like 0.53 is displayed as 53%.

从ICU 4.2开始，您可以通过传入'style'作为参数来使用getInstance（）来获取正确的实例。 例如，使用getInstance（... NUMBERSTYLE）获取正常的数字格式，getInstance（... PERCENTSTYLE）获取显示百分比的格式，getInstance（... SCIENTIFICSTYLE）获取显示科学编号的格式，getInstance （... INTEGERSTYLE）获取整数数字格式getInstance（... CURRENCYSTYLE）以获取货币数字格式，货币用符号表示，例如“$ 3.00”。 getInstance（... ISOCURRENCYSTYLE）获取货币数字格式，其货币由ISO代码表示，例如“USD3.00”。 getInstance（... PLURALCURRENCYSTYLE）获取货币格式，其中货币以复数格式表示其全名，例如“3.00美元”或“1.00美元”。

您还可以使用setMinimumFractionDigits等方法控制数字的显示。 如果你想在格式或对其进行解析更大的控制权，或者希望给用户更多的控制，你可以尝试铸造NumberFormat你从工厂方法到获得DecimalFormat 。 这将适用于绝大多数地区; 只要记得把它放在try区块，以防遇到不寻常的问题。

NumberFormat的设计使得一些控件可用于格式化，其他控件可用于解析。 以下是每种这些控制方法的详细描述，

setParseIntegerOnly：仅影响解析，例如，如果为true，则为“3456.78” - > 3456（并且离开解析位置在'6'之后）如果为假，“3456.78” - > 3456.78（并且离开解析位置紧跟在“8”之后）独立于格式。 如果您不想在小数点后面没有数字的位置显示小数点，请在DecimalFormat上使用setDecimalSeparatorAlwaysShown。

您还可以使用 parse和 format方法与 ParsePosition和 FieldPosition方法，以便您：

For example, you can align numbers in two ways:
  1. If you are using a monospaced font with spacing for alignment, you can pass the FieldPosition in your format call, with field = INTEGER_FIELD. On output, getEndIndex will be set to the offset between the last character of the integer and the decimal. Add (desiredSpaceCount - getEndIndex) spaces at the front of the string.
  2. If you are using proportional fonts, instead of padding with spaces, measure the width of the string in pixels from the start to getEndIndex. Then move the pen by (desiredPixelWidth - widthToAlignmentPoint) before drawing the text. It also works where there is no decimal, but possibly additional characters at the end, e.g., with parentheses in negative numbers: "(12)" for -12.

Synchronization

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

DecimalFormat

DecimalFormat是NumberFormat的具体实现，NumberFormat API实质上是DecimalFormat API的抽象。 有关此API的更多信息，请参阅DecimalFormat。

see DecimalFormat see java.text.ChoiceFormat

Summary

Nested classes
class NumberFormat.Field

此内部类的实例用作NumberFormat.formatToCharacterIterator（）方法返回的AttributedCharacterIterator中的属性键和值。

Constants
int ACCOUNTINGCURRENCYSTYLE

[icu]常量，指定使用货币符号表示记帐货币的格式货币格式，例如：“（$ 3.00）”，而不是“ - $ 3.00”（ CURRENCYSTYLE ）。
int CASHCURRENCYSTYLE

[icu]用于指定使用货币ISO代码表示货币的格式的货币现金风格的常量，例如：“NT $ 3”而不是“NT $ 3.23”。
int CURRENCYSTYLE

[icu]常量，用于指定格式的通用货币风格。
int FRACTION_FIELD

用于构造FieldPosition对象的字段常量。
int INTEGERSTYLE

[icu]用于指定整数数字样式格式的常数。
int INTEGER_FIELD

用于构造FieldPosition对象的字段常量。
int ISOCURRENCYSTYLE

[icu]常量，用于指定使用货币ISO代码表示货币的格式的货币格式，例如：“USD3.00”。
int NUMBERSTYLE

[icu]常量来指定格式的正常数字样式。
int PERCENTSTYLE

[icu]常量，用于指定显示百分比的格式样式。
int PLURALCURRENCYSTYLE

[icu]常数，用于指定使用货币长名称以多种格式表示货币的格式的货币格式，例如“3.00美元”。
int SCIENTIFICSTYLE

[icu]用于指定显示科学编号的格式样式的常量。

Public constructors
NumberFormat()

空构造函数。

Public methods
Object clone()

覆盖克隆。
boolean equals(Object obj)

覆盖等于。
abstract StringBuffer format(BigInteger number, StringBuffer toAppendTo, FieldPosition pos)

[icu]格式化BigInteger。
abstract StringBuffer format(BigDecimal number, StringBuffer toAppendTo, FieldPosition pos)

[icu]格式化ICU BigDecimal。
StringBuffer format(Object number, StringBuffer toAppendTo, FieldPosition pos)

格式化数字并将结果文本附加到给定的字符串缓冲区。
final String format(BigDecimal number)

便捷方法来格式化BigDecimal。
abstract StringBuffer format(double number, StringBuffer toAppendTo, FieldPosition pos)

格式专业化。
final String format(BigInteger number)

[icu]格式化BigInteger的便捷方法。
abstract StringBuffer format(BigDecimal number, StringBuffer toAppendTo, FieldPosition pos)

[icu]格式化BigDecimal。
final String format(BigDecimal number)

[icu]格式化ICU BigDecimal的便捷方法。
final String format(double number)

格式专业化。
final String format(long number)

格式专业化。
StringBuffer format(CurrencyAmount currAmt, StringBuffer toAppendTo, FieldPosition pos)

[icu]格式CurrencyAmount。
final String format(CurrencyAmount currAmt)

[icu]格式化CurrencyAmount的便捷方法。
abstract StringBuffer format(long number, StringBuffer toAppendTo, FieldPosition pos)

格式专业化。
static Locale[] getAvailableLocales()

返回NumberFormats可用的语言环境列表。
DisplayContext getContext(DisplayContext.Type type)

[icu]获取指定DisplayContext.Type的格式化程序的DisplayContext值，例如CAPITALIZATION。
Currency getCurrency()

返回用于显示货币金额的 Currency对象。
static NumberFormat getCurrencyInstance(Locale inLocale)

返回指定语言环境的货币格式。
static NumberFormat getCurrencyInstance(ULocale inLocale)

[icu]返回指定语言环境的货币格式。
static final NumberFormat getCurrencyInstance()

返回当前默认 FORMAT区域设置的货币格式。
static final NumberFormat getInstance()

返回当前默认 FORMAT语言环境的默认数字格式。
static NumberFormat getInstance(Locale inLocale)

返回指定语言环境的默认数字格式。
static NumberFormat getInstance(ULocale desiredLocale, int choice)

返回特定区域设置的特定样式数字格式。
static NumberFormat getInstance(Locale inLocale, int style)

[icu]返回特定区域设置的特定样式编号格式。
static NumberFormat getInstance(ULocale inLocale)

[icu]返回指定语言环境的默认数字格式。
static final NumberFormat getInstance(int style)

[icu]返回默认 FORMAT语言环境的特定样式编号格式。
static NumberFormat getIntegerInstance(ULocale inLocale)

[icu]返回指定语言环境的整数数字格式。
static final NumberFormat getIntegerInstance()

返回当前默认 FORMAT语言环境的整数数字格式。
static NumberFormat getIntegerInstance(Locale inLocale)

返回指定语言环境的整数数字格式。
int getMaximumFractionDigits()

返回数字的小数部分中允许的最大位数。
int getMaximumIntegerDigits()

返回数字整数部分允许的最大位数。
int getMinimumFractionDigits()

返回数字的小数部分中允许的最小位数。
int getMinimumIntegerDigits()

返回数字整数部分允许的最小位数。
static NumberFormat getNumberInstance(ULocale inLocale)

[icu]返回指定语言环境的通用数字格式。
static final NumberFormat getNumberInstance()

返回当前默认 FORMAT语言环境的通用数字格式。
static NumberFormat getNumberInstance(Locale inLocale)

返回指定语言环境的通用数字格式。
static final NumberFormat getPercentInstance()

返回当前默认 FORMAT区域设置的百分比格式。
static NumberFormat getPercentInstance(Locale inLocale)

返回指定语言环境的百分比格式。
static NumberFormat getPercentInstance(ULocale inLocale)

[icu]返回指定语言环境的百分比格式。
int getRoundingMode()

返回此NumberFormat中使用的舍入模式。
static NumberFormat getScientificInstance(ULocale inLocale)

[icu]返回指定语言环境的科学格式。
static NumberFormat getScientificInstance(Locale inLocale)

[icu]返回指定语言环境的科学格式。
static final NumberFormat getScientificInstance()

[icu]返回当前默认 FORMAT语言环境的科学格式。
int hashCode()

重写hashCode。
boolean isGroupingUsed()

如果以此格式使用分组，则返回true。
boolean isParseIntegerOnly()

如果此格式仅将数字解析为整数，则返回true。
boolean isParseStrict()

[icu]返回严格解析是否有效。
Number parse(String text)

从给定字符串的开头解析文本以产生一个数字。
abstract Number parse(String text, ParsePosition parsePosition)

如果可能的话返回一个Long（例如，在[Long.MIN_VALUE，Long.MAX_VALUE]范围内且没有小数），否则返回Double。
CurrencyAmount parseCurrency(CharSequence text, ParsePosition pos)

将给定字符串中的文本解析为CurrencyAmount。
final Object parseObject(String source, ParsePosition parsePosition)

解析字符串中的文本以产生一个数字。
void setContext(DisplayContext context)

[icu]在格式化程序中设置特定的DisplayContext值，例如CAPITALIZATION_FOR_STANDALONE。
void setCurrency(Currency theCurrency)

设置用于显示货币金额的 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 setParseStrict(boolean value)

[icu]设置严格分析是否有效。
void setRoundingMode(int roundingMode)

设置此NumberFormat中使用的舍入模式。

Protected methods
static String getPattern(ULocale forLocale, int choice)

返回提供的语言环境和选择的模式。

Inherited methods
From class java.text.Format
From class java.lang.Object

Constants

ACCOUNTINGCURRENCYSTYLE

Added in API level 24 
int ACCOUNTINGCURRENCYSTYLE

[icu]常量，用于指定使用货币符号表示记帐货币的格式的货币格式，例如：“（$ 3.00）”，而不是“ - $ 3.00”（ CURRENCYSTYLE ）。使用locale中的-cf-键覆盖任何指定的格式。

常量值：7（0x00000007）

CASHCURRENCYSTYLE

Added in API level 24 
int CASHCURRENCYSTYLE

[icu]用于指定使用货币ISO代码表示货币的格式的货币现金风格的常量，例如：“NT $ 3”而不是“NT $ 3.23”。

常量值：8（0x00000008）

CURRENCYSTYLE

Added in API level 24 
int CURRENCYSTYLE

[icu]常量，用于指定格式的通用货币风格。 默认为STANDARDCURRENCYSTYLE，使用货币符号，例如“$ 3.00”，非会计样式用于负值（例如减号）。 具体样式可以使用-cf-locale键来指定。

常数值：1（0x00000001）

FRACTION_FIELD

Added in API level 24 
int FRACTION_FIELD

用于构造FieldPosition对象的字段常量。 表示应该返回格式化数字的小数部分的位置。

也可以看看：

常数值：1（0x00000001）

INTEGERSTYLE

Added in API level 24 
int INTEGERSTYLE

[icu]用于指定整数数字样式格式的常数。

常量值：4（0x00000004）

INTEGER_FIELD

Added in API level 24 
int INTEGER_FIELD

用于构造FieldPosition对象的字段常量。 表示应该返回格式化数字的整数部分的位置。

也可以看看：

常量值：0（0x00000000）

ISOCURRENCYSTYLE

Added in API level 24 
int ISOCURRENCYSTYLE

[icu]常量，用于指定使用货币ISO代码表示货币的格式的货币格式，例如：“USD3.00”。

常量值：5（0x00000005）

NUMBERSTYLE

Added in API level 24 
int NUMBERSTYLE

[icu]常量来指定格式的正常数字样式。

常量值：0（0x00000000）

PERCENTSTYLE

Added in API level 24 
int PERCENTSTYLE

[icu]常量，用于指定显示百分比的格式样式。

常量值：2（0x00000002）

PLURALCURRENCYSTYLE

Added in API level 24 
int PLURALCURRENCYSTYLE

[icu]常数，用于指定使用货币长名称以多种格式表示货币的格式的货币格式，例如“3.00美元”。

常数值：6（0x00000006）

SCIENTIFICSTYLE

Added in API level 24 
int SCIENTIFICSTYLE

[icu]用于指定显示科学编号的格式样式的常量。

常量值：3（0x00000003）

Public constructors

NumberFormat

Added in API level 24 
NumberFormat ()

空构造函数。 公开与具有公共构造函数的历史版本NumberFormat API兼容，尽管这是一个抽象类。

Public methods

clone

Added in API level 24 
Object clone ()

覆盖克隆。

Returns
Object a clone of this instance.

equals

Added in API level 24 
boolean equals (Object obj)

覆盖等于。 如果两个NumberFormat属于同一个类并且设置（groupingUsed，parseIntegerOnly，maximumIntegerDigits等等）相等，则两个NumberFormat相等。

Parameters
obj Object: the object to compare against
Returns
boolean true if the object is equal to this.

format

Added in API level 24 
StringBuffer format (BigInteger number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

[icu]格式化BigInteger。 格式专业化。

Parameters
number BigInteger
toAppendTo StringBuffer
pos FieldPosition
Returns
StringBuffer

也可以看看：

format

Added in API level 24 
StringBuffer format (BigDecimal number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

[icu]格式化ICU BigDecimal。 格式专业化。

Parameters
number BigDecimal
toAppendTo StringBuffer
pos FieldPosition
Returns
StringBuffer

也可以看看：

format

Added in API level 24 
StringBuffer format (Object number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

格式化数字并将结果文本附加到给定的字符串缓冲区。 [icu]注意：识别BigInteger和BigDecimal对象。

Parameters
number Object: The object to format
toAppendTo StringBuffer: where the text is to be appended
pos FieldPosition: A FieldPosition identifying a field in the formatted text
Returns
StringBuffer the string buffer passed in as toAppendTo, with formatted text appended

也可以看看：

format

Added in API level 24 
String format (BigDecimal number)

便捷方法来格式化BigDecimal。

Parameters
number BigDecimal
Returns
String

format

Added in API level 24 
StringBuffer format (double number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

格式专业化。

Parameters
number double
toAppendTo StringBuffer
pos FieldPosition
Returns
StringBuffer

也可以看看：

format

Added in API level 24 
String format (BigInteger number)

[icu]格式化BigInteger的便捷方法。

Parameters
number BigInteger
Returns
String

format

Added in API level 24 
StringBuffer format (BigDecimal number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

[icu]格式化BigDecimal。 格式专业化。

Parameters
number BigDecimal
toAppendTo StringBuffer
pos FieldPosition
Returns
StringBuffer

也可以看看：

format

Added in API level 24 
String format (BigDecimal number)

[icu]格式化ICU BigDecimal的便捷方法。

Parameters
number BigDecimal
Returns
String

format

Added in API level 24 
String format (double number)

格式专业化。

Parameters
number double
Returns
String

也可以看看：

format

Added in API level 24 
String format (long number)

格式专业化。

Parameters
number long
Returns
String

也可以看看：

format

Added in API level 24 
StringBuffer format (CurrencyAmount currAmt, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

[icu]格式CurrencyAmount。 格式专业化。

Parameters
currAmt CurrencyAmount
toAppendTo StringBuffer
pos FieldPosition
Returns
StringBuffer

也可以看看：

format

Added in API level 24 
String format (CurrencyAmount currAmt)

[icu]格式化CurrencyAmount的便捷方法。

Parameters
currAmt CurrencyAmount
Returns
String

format

Added in API level 24 
StringBuffer format (long number, 
                StringBuffer toAppendTo, 
                FieldPosition pos)

格式专业化。

Parameters
number long
toAppendTo StringBuffer
pos FieldPosition
Returns
StringBuffer

也可以看看：

getAvailableLocales

Added in API level 24 
Locale[] getAvailableLocales ()

返回NumberFormats可用的语言环境列表。

Returns
Locale[] the available locales

getContext

Added in API level 24 
DisplayContext getContext (DisplayContext.Type type)

[icu]获取指定DisplayContext.Type的格式化程序的DisplayContext值，例如CAPITALIZATION。

Parameters
type DisplayContext.Type: the DisplayContext.Type whose value to return
Returns
DisplayContext the current DisplayContext setting for the specified type

getCurrency

Added in API level 24 
Currency getCurrency ()

返回用于显示货币金额的Currency对象。 这可能是空的。

Returns
Currency

getCurrencyInstance

Added in API level 24 
NumberFormat getCurrencyInstance (Locale inLocale)

返回指定语言环境的货币格式。

Parameters
inLocale Locale
Returns
NumberFormat a number format for currency

getCurrencyInstance

Added in API level 24 
NumberFormat getCurrencyInstance (ULocale inLocale)

[icu]返回指定语言环境的货币格式。

Parameters
inLocale ULocale
Returns
NumberFormat a number format for currency

getCurrencyInstance

Added in API level 24 
NumberFormat getCurrencyInstance ()

返回当前默认 FORMAT区域设置的货币格式。

Returns
NumberFormat a number format for currency

也可以看看：

getInstance

Added in API level 24 
NumberFormat getInstance ()

返回当前默认FORMAT语言环境的默认数字格式。 默认格式是其他工厂方法提供的样式之一：getNumberInstance，getIntegerInstance，getCurrencyInstance或getPercentInstance。 究竟哪一个是区域依赖的。

Returns
NumberFormat

也可以看看：

getInstance

Added in API level 24 
NumberFormat getInstance (Locale inLocale)

返回指定语言环境的默认数字格式。 默认格式是其他工厂方法提供的样式之一：getNumberInstance，getCurrencyInstance或getPercentInstance。 究竟哪一个是区域依赖的。

Parameters
inLocale Locale
Returns
NumberFormat

getInstance

Added in API level 24 
NumberFormat getInstance (ULocale desiredLocale, 
                int choice)

返回特定区域设置的特定样式数字格式。

Parameters
desiredLocale ULocale: the specific locale.
choice int: number format style
Returns
NumberFormat
Throws
IllegalArgumentException if choice is not one of NUMBERSTYLE, CURRENCYSTYLE, PERCENTSTYLE, SCIENTIFICSTYLE, INTEGERSTYLE, ISOCURRENCYSTYLE, PLURALCURRENCYSTYLE, ACCOUNTINGCURRENCYSTYLE. CASHCURRENCYSTYLE, STANDARDCURRENCYSTYLE.

getInstance

Added in API level 24 
NumberFormat getInstance (Locale inLocale, 
                int style)

[icu]返回特定区域设置的特定样式编号格式。

Parameters
inLocale Locale: the specific locale.
style int: number format style
Returns
NumberFormat

getInstance

Added in API level 24 
NumberFormat getInstance (ULocale inLocale)

[icu]返回指定语言环境的默认数字格式。 默认格式是其他工厂方法提供的样式之一：getNumberInstance，getCurrencyInstance或getPercentInstance。 究竟哪一个是区域依赖的。

Parameters
inLocale ULocale
Returns
NumberFormat

getInstance

Added in API level 24 
NumberFormat getInstance (int style)

[icu]返回默认 FORMAT语言环境的特定样式编号格式。

Parameters
style int: number format style
Returns
NumberFormat

也可以看看：

getIntegerInstance

Added in API level 24 
NumberFormat getIntegerInstance (ULocale inLocale)

[icu]返回指定语言环境的整数数字格式。 返回的数字格式被配置为使用IEEE half-even舍入（请参阅ROUND_HALF_EVEN ）将浮点数整数到最接近的整数进行格式化，并仅解析输入字符串的整数部分（请参阅isParseIntegerOnly ）。

Parameters
inLocale ULocale: the locale for which a number format is needed
Returns
NumberFormat a number format for integer values

getIntegerInstance

Added in API level 24 
NumberFormat getIntegerInstance ()

返回当前默认FORMAT区域设置的整数数字格式。 返回的数字格式被配置为使用IEEE半双舍ROUND_HALF_EVEN （请参阅ROUND_HALF_EVEN ）将浮点数整数到最接近的整数进行格式化，并仅解析输入字符串的整数部分（请参阅isParseIntegerOnly ）。

Returns
NumberFormat a number format for integer values

也可以看看：

getIntegerInstance

Added in API level 24 
NumberFormat getIntegerInstance (Locale inLocale)

返回指定语言环境的整数数字格式。 返回的数字格式被配置为使用IEEE半双舍ROUND_HALF_EVEN （请参阅ROUND_HALF_EVEN ）将浮点数整数到最接近的整数以进行格式化，并仅解析输入字符串的整数部分（请参阅isParseIntegerOnly ）。

Parameters
inLocale Locale: the locale for which a number format is needed
Returns
NumberFormat a number format for integer values

getMaximumFractionDigits

Added in API level 24 
int getMaximumFractionDigits ()

返回数字的小数部分中允许的最大位数。 默认值是3，哪些子类可以覆盖。 格式化时，超过此值时的确切行为是特定于子类的。 解析时，这不起作用。

Returns
int the maximum number of fraction digits

也可以看看：

getMaximumIntegerDigits

Added in API level 24 
int getMaximumIntegerDigits ()

返回数字整数部分允许的最大位数。 默认值是40，哪个子类可以覆盖。 格式化时，超过此值时的确切行为是特定于子类的。 解析时，这不起作用。

Returns
int the maximum number of integer digits

也可以看看：

getMinimumFractionDigits

Added in API level 24 
int getMinimumFractionDigits ()

返回数字的小数部分中允许的最小位数。 默认值是0，哪个子类可以覆盖。 格式化时，如果未达到此值，则会在右侧填充数字，并使用特定于语言环境的“0”字符来确保至少包含此数字的小数位数。 解析时，这不起作用。

Returns
int the minimum number of fraction digits

也可以看看：

getMinimumIntegerDigits

Added in API level 24 
int getMinimumIntegerDigits ()

返回数字整数部分允许的最小位数。 默认值是1，哪些子类可以覆盖。 格式化时，如果未达到此值，则会在左侧填充数字，并使用特定于语言环境的“0”字符来确保至少包含此数字的整数位数。 解析时，这不起作用。

Returns
int the minimum number of integer digits

也可以看看：

getNumberInstance

Added in API level 24 
NumberFormat getNumberInstance (ULocale inLocale)

[icu]返回指定语言环境的通用数字格式。

Parameters
inLocale ULocale
Returns
NumberFormat

getNumberInstance

Added in API level 24 
NumberFormat getNumberInstance ()

返回当前默认 FORMAT区域设置的通用数字格式。

Returns
NumberFormat

也可以看看：

getNumberInstance

Added in API level 24 
NumberFormat getNumberInstance (Locale inLocale)

返回指定语言环境的通用数字格式。

Parameters
inLocale Locale
Returns
NumberFormat

getPercentInstance

Added in API level 24 
NumberFormat getPercentInstance ()

返回当前默认 FORMAT语言环境的百分比格式。

Returns
NumberFormat a number format for percents

也可以看看：

getPercentInstance

Added in API level 24 
NumberFormat getPercentInstance (Locale inLocale)

返回指定语言环境的百分比格式。

Parameters
inLocale Locale
Returns
NumberFormat a number format for percents

getPercentInstance

Added in API level 24 
NumberFormat getPercentInstance (ULocale inLocale)

[icu]返回指定语言环境的百分比格式。

Parameters
inLocale ULocale
Returns
NumberFormat a number format for percents

getRoundingMode

Added in API level 24 
int getRoundingMode ()

返回此NumberFormat中使用的舍入模式。 NumberFormat中tis方法的默认实现总是抛出UnsupportedOperationException 。

Returns
int A rounding mode, between BigDecimal.ROUND_UP and BigDecimal.ROUND_UNNECESSARY.

也可以看看：

getScientificInstance

Added in API level 24 
NumberFormat getScientificInstance (ULocale inLocale)

[icu]返回指定语言环境的科学格式。

Parameters
inLocale ULocale
Returns
NumberFormat a scientific number format

getScientificInstance

Added in API level 24 
NumberFormat getScientificInstance (Locale inLocale)

[icu]返回指定语言环境的科学格式。

Parameters
inLocale Locale
Returns
NumberFormat a scientific number format

getScientificInstance

Added in API level 24 
NumberFormat getScientificInstance ()

[icu]返回当前默认 FORMAT语言环境的科学格式。

Returns
NumberFormat a scientific number format

也可以看看：

hashCode

Added in API level 24 
int hashCode ()

重写hashCode。

Returns
int a hash code value for this object.

isGroupingUsed

Added in API level 24 
boolean isGroupingUsed ()

如果以此格式使用分组，则返回true。 例如，在en_US区域设置中，编号为1234567的数字将被格式化为“1,234,567”。 分组分隔符以及每个组的大小取决于语言环境，由NumberFormat的子类决定。 分组会影响解析和格式。

Returns
boolean true if grouping is used

也可以看看：

isParseIntegerOnly

Added in API level 24 
boolean isParseIntegerOnly ()

如果此格式仅将数字解析为整数，则返回true。 例如在英文语言环境中，ParseIntegerOnly为true，字符串“1234”。 将被解析为整数值1234，解析将停止在“。”处。 字符。 分析操作接受的小数分隔符是由语言环境决定的，并由子类决定。

Returns
boolean true if this will parse integers only

isParseStrict

Added in API level 24 
boolean isParseStrict ()

[icu]返回严格解析是否有效。

Returns
boolean true if strict parsing is in effect

也可以看看：

parse

Added in API level 24 
Number parse (String text)

从给定字符串的开头解析文本以产生一个数字。 该方法可能不会使用给定字符串的整个文本。

Parameters
text String: A String whose beginning should be parsed.
Returns
Number A Number parsed from the string.
Throws
ParseException if the beginning of the specified string cannot be parsed.

也可以看看：

parse

Added in API level 24 
Number parse (String text, 
                ParsePosition parsePosition)

如果可能的话返回一个Long（例如，在[Long.MIN_VALUE，Long.MAX_VALUE]范围内且没有小数），否则返回Double。 如果设置了IntegerOnly，将停止在小数点处（或等效;例如，对于有理数“1 2/3”，将在1之后停止）。 不抛出异常; 如果没有对象可以被解析，索引是不变的！

Parameters
text String
parsePosition ParsePosition
Returns
Number

也可以看看：

parseCurrency

Added in API level 24 
CurrencyAmount parseCurrency (CharSequence text, 
                ParsePosition pos)

将给定字符串中的文本解析为CurrencyAmount。 与parse（）方法不同，此方法将尝试解析通用货币名称，搜索此对象的区域设置的货币显示名称的匹配项或3个字母的ISO货币代码。 如果此格式不是货币格式，即它的前缀或后缀中不包含货币格式符号（U + 00A4），则此方法将失败。

Parameters
text CharSequence: the text to parse
pos 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
CurrencyAmount a CurrencyAmount, or null upon failure

parseObject

Added in API level 24 
Object parseObject (String source, 
                ParsePosition parsePosition)

解析字符串中的文本以产生一个数字。

Parameters
source String: the String to parse
parsePosition ParsePosition: the position at which to start the parse
Returns
Object the parsed number, or null

也可以看看：

setContext

Added in API level 24 
void setContext (DisplayContext context)

[icu]在格式化程序中设置特定的DisplayContext值，例如CAPITALIZATION_FOR_STANDALONE。

Parameters
context DisplayContext: The DisplayContext value to set.

setCurrency

Added in API level 24 
void setCurrency (Currency theCurrency)

设置用于显示货币金额的Currency对象。 如果这种格式是货币格式，这将立即生效。 如果此格式不是货币格式，则在此对象成为货币格式时使用货币对象。

Parameters
theCurrency Currency: new currency object to use. May be null for some subclasses.

setGroupingUsed

Added in API level 24 
void setGroupingUsed (boolean newValue)

设置是否以此格式使用分组。 分组会影响解析和格式。

Parameters
newValue boolean: true to use grouping.

也可以看看：

setMaximumFractionDigits

Added in API level 24 
void setMaximumFractionDigits (int newValue)

设置数字的小数部分允许的最大位数。 这必须> = minimumFractionDigits。 如果maximumFractionDigits的新值小于minimumFractionDigits的当前值，那么minimumFractionDigits也将被设置为新值。

Parameters
newValue int: the maximum number of fraction digits to be shown; if less than zero, then zero is used. The concrete subclass may enforce an upper limit to this value appropriate to the numeric type being formatted.

也可以看看：

setMaximumIntegerDigits

Added in API level 24 
void setMaximumIntegerDigits (int newValue)

设置数字整数部分允许的最大位数。 这必须> = minimumIntegerDigits。 如果maximumIntegerDigits的新值小于minimumIntegerDigits的当前值，那么minimumIntegerDigits也将被设置为新值。

Parameters
newValue int: the maximum number of integer digits to be shown; if less than zero, then zero is used. Subclasses might enforce an upper limit to this value appropriate to the numeric type being formatted.

也可以看看：

setMinimumFractionDigits

Added in API level 24 
void setMinimumFractionDigits (int newValue)

设置数字的小数部分中允许的最小位数。 这必须是<= maximumFractionDigits。 如果minimumFractionDigits的新值超过maximumFractionDigits的当前值，则maximumFractionDigits也将设置为新值。

Parameters
newValue int: the minimum number of fraction digits to be shown; if less than zero, then zero is used. Subclasses might enforce an upper limit to this value appropriate to the numeric type being formatted.

也可以看看：

setMinimumIntegerDigits

Added in API level 24 
void setMinimumIntegerDigits (int newValue)

设置数字整数部分允许的最小位数。 这必须<= maximumIntegerDigits。 如果minimumIntegerDigits的新值大于maximumIntegerDigits的当前值，则maximumIntegerDigits也将被设置为新值。

Parameters
newValue int: the minimum number of integer digits to be shown; if less than zero, then zero is used. Subclasses might enforce an upper limit to this value appropriate to the numeric type being formatted.

也可以看看：

setParseIntegerOnly

Added in API level 24 
void setParseIntegerOnly (boolean value)

设置数字是否应该仅被解析为整数。

Parameters
value boolean: true if this should parse integers only

也可以看看：

setParseStrict

Added in API level 24 
void setParseStrict (boolean value)

[icu]设置严格分析是否有效。 如果这是真的，则以下情况会导致解析失败（示例使用模式“＃，## 0.＃”）：

  • 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
value boolean: True to enable strict parsing. Default is false.

也可以看看：

setRoundingMode

Added in API level 24 
void setRoundingMode (int roundingMode)

设置此NumberFormat中使用的舍入模式。 NumberFormat中的tis方法的默认实现总是抛出UnsupportedOperationException 。

Parameters
roundingMode int: A rounding mode, between BigDecimal.ROUND_UP and BigDecimal.ROUND_UNNECESSARY.

也可以看看：

Protected methods

getPattern

Added in API level 24 
String getPattern (ULocale forLocale, 
                int choice)

返回提供的语言环境和选择的模式。

Parameters
forLocale ULocale: the locale of the data.
choice int: the pattern format.
Returns
String the pattern
Android开发手册

Hooray!