Most visited

Recently visited

Added in API level 24

DecimalFormatSymbols

public class DecimalFormatSymbols
extends Object implements Cloneable, Serializable

java.lang.Object
   ↳ android.icu.text.DecimalFormatSymbols


[icu增强] ICU的替代DecimalFormatSymbols ICU特有的方法,字段和其他功能标记为“ [icu] ”。 该类代表DecimalFormat为格式化数字所需的一组符号(例如小数分隔符,分组分隔符等)。 DecimalFormat从其语言环境数据为其自身创建一个DecimalFormatSymbols的实例。 如果您需要更改这些符号中的任何一个,则可以从DecimalFormat获取DecimalFormatSymbols对象并对其进行修改。

也可以看看:

Summary

Constants

int CURRENCY_SPC_CURRENCY_MATCH

[icu]表示 getPatternForCurrencySpacing(int, boolean)使用的货币匹配模式。

int CURRENCY_SPC_INSERT

[icu]表示 getPatternForCurrencySpacing(int, boolean)使用的插入值。

int CURRENCY_SPC_SURROUNDING_MATCH

[icu]表示 getPatternForCurrencySpacing(int, boolean)使用的周边匹配模式。

Public constructors

DecimalFormatSymbols()

为默认的 FORMAT语言环境创建DecimalFormatSymbols对象。

DecimalFormatSymbols(Locale locale)

为给定的语言环境创建DecimalFormatSymbols对象。

DecimalFormatSymbols(ULocale locale)

[icu]为给定语言环境创建DecimalFormatSymbols对象。

Public methods

Object clone()

创建并返回此对象的副本。

boolean equals(Object obj)

指示其他某个对象是否“等于”这一个。

static Locale[] getAvailableLocales()

返回 getInstance方法可返回本地化实例的所有语言环境的数组。

Currency getCurrency()

返回货币符号,仅适用于 getCurrency() API兼容性。

String getCurrencySymbol()

返回表示本地货币的字符串。

char getDecimalSeparator()

返回用于十进制符号的字符。

char getDigit()

返回模式中用于数字的字符。

char[] getDigits()

按照从0到9的顺序返回用作数字的字符数组

String getExponentMultiplicationSign()

返回乘号

String getExponentSeparator()

[icu]返回用于将尾数与指数分开的字符串。

char getGroupingSeparator()

返回用于千位分隔符的字符。

String getInfinity()

返回用于表示无穷大的字符串。

static DecimalFormatSymbols getInstance()

返回默认语言环境的DecimalFormatSymbols实例。

static DecimalFormatSymbols getInstance(Locale locale)

返回给定语言环境的DecimalFormatSymbols实例。

static DecimalFormatSymbols getInstance(ULocale locale)

返回给定语言环境的DecimalFormatSymbols实例。

String getInternationalCurrencySymbol()

返回表示本地货币的国际字符串。

Locale getLocale()

返回构造此对象的语言环境。

char getMinusSign()

返回用于表示减号的字符。

char getMonetaryDecimalSeparator()

返回货币小数点分隔符。

char getMonetaryGroupingSeparator()

[icu]返回货币分组分隔符。

String getNaN()

返回用于表示NaN的字符串。

char getPadEscape()

[icu]返回用于将数字填充到指定宽度的字符。

String getPatternForCurrencySpacing(int itemType, boolean beforeCurrency)

[icu]返回所需的货币间隔值。

char getPatternSeparator()

返回用于在模式中分隔正和负子模式的字符。

char getPerMill()

返回用于百分号的字符。

char getPercent()

返回用于百分号的字符。

char getPlusSign()

[icu]返回局部加号。

char getSignificantDigit()

返回用于表示模式中有效数字的字符。

ULocale getULocale()

返回构造此对象的语言环境。

char getZeroDigit()

返回用于零的字符。

int hashCode()

返回对象的哈希码值。

void setCurrency(Currency currency)

设置货币。

void setCurrencySymbol(String currency)

设置表示本地货币的字符串。

void setDecimalSeparator(char decimalSeparator)

设置用于十进制符号的字符。

void setDigit(char digit)

设置模式中用于数字的字符。

void setExponentMultiplicationSign(String exponentMultiplicationSign)

设置乘号

void setExponentSeparator(String exp)

[icu]设置用于将尾数与指数分开的字符串。

void setGroupingSeparator(char groupingSeparator)

设置用于千位分隔符的字符。

void setInfinity(String infinity)

设置用于表示无穷大的字符串。

void setInternationalCurrencySymbol(String currency)

设置表示本地货币的国际字符串。

void setMinusSign(char minusSign)

设置用于表示减号的字符。

void setMonetaryDecimalSeparator(char sep)

设置货币小数点分隔符。

void setMonetaryGroupingSeparator(char sep)

设置货币小数点分隔符。

void setNaN(String NaN)

设置用于表示NaN的字符串。

void setPadEscape(char c)

[icu]设置用于将数字填充到指定宽度的字符。

void setPatternForCurrencySpacing(int itemType, boolean beforeCurrency, String pattern)

[icu]设置指示的货币间隔模式或值。

void setPatternSeparator(char patternSeparator)

设置用于在模式中分隔正面和负面子模式的字符。

void setPerMill(char perMill)

设置用于千分比符号的字符。

void setPercent(char percent)

设置用于百分号的字符。

void setPlusSign(char plus)

[icu]设置局部加号。

void setSignificantDigit(char sigDigit)

设置用于表示模式中有效数字的字符。

void setZeroDigit(char zeroDigit)

设置用于零的字符。

Inherited methods

From class java.lang.Object

Constants

CURRENCY_SPC_CURRENCY_MATCH

Added in API level 24
int CURRENCY_SPC_CURRENCY_MATCH

[icu]表示 getPatternForCurrencySpacing(int, boolean)使用的货币匹配模式。

常量值:0(0x00000000)

CURRENCY_SPC_INSERT

Added in API level 24
int CURRENCY_SPC_INSERT

[icu]表示 getPatternForCurrencySpacing(int, boolean)使用的插入值。

常量值:2(0x00000002)

CURRENCY_SPC_SURROUNDING_MATCH

Added in API level 24
int CURRENCY_SPC_SURROUNDING_MATCH

[icu]表示 getPatternForCurrencySpacing(int, boolean)使用的周边匹配模式。

常数值:1(0x00000001)

Public constructors

DecimalFormatSymbols

Added in API level 24
DecimalFormatSymbols ()

为默认的 FORMAT语言环境创建DecimalFormatSymbols对象。

也可以看看:

DecimalFormatSymbols

Added in API level 24
DecimalFormatSymbols (Locale locale)

为给定的语言环境创建DecimalFormatSymbols对象。

Parameters
locale Locale: the locale

DecimalFormatSymbols

Added in API level 24
DecimalFormatSymbols (ULocale locale)

[icu]为给定语言环境创建DecimalFormatSymbols对象。

Parameters
locale ULocale: the locale

Public methods

clone

Added in API level 24
Object clone ()

创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是,对于任何对象x ,表达式:

 x.clone() != x
will be true, and that the expression:
 x.clone().getClass() == x.getClass()
will be true, but these are not absolute requirements. While it is typically the case that:
 x.clone().equals(x)
will be true, this is not an absolute requirement.

按照惯例,返回的对象应该通过调用super.clone获得。 如果一个类和它的所有超类( Object除外)都遵守这个约定,那么情况就是x.clone().getClass() == x.getClass()

按照惯例,这个方法返回的对象应该独立于这个对象(被克隆)。 为了实现这种独立性,可能需要在返回super.clone之前修改返回的对象的一个或多个字段。 通常,这意味着复制包含被克隆对象的内部“深层结构”的任何可变对象,并将这些对象的引用替换为对这些副本的引用。 如果一个类只包含原始字段或对不可变对象的引用,那么通常情况下,不需要修改由super.clone返回的对象中的字段。

Object的方法clone执行特定的克隆操作。 首先,如果该对象的类没有实现接口Cloneable ,则引发CloneNotSupportedException 请注意,所有数组都被认为实现了接口Cloneable并且数组类型T[]clone方法的返回类型为T[] ,其中T是任何引用或基本类型。 否则,此方法创建该对象的类的新实例,并使用该对象的相应字段的内容来初始化其所有字段,就像通过赋值一样; 这些字段的内容本身并不克隆。 因此,此方法执行此对象的“浅拷贝”,而不是“深拷贝”操作。

Object本身并不实现接口 Cloneable ,所以在类 Object的对象上调用 clone方法将导致在运行时抛出异常。

Returns
Object a clone of this instance.

equals

Added in API level 24
boolean equals (Object obj)

指示其他某个对象是否“等于”这一个。

equals方法在非空对象引用上实现等价关系:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

equals方法Object实现了对象上最可能的等价关系; 也就是说,对于任何非空参考值xy ,当且仅当xy引用同一对象( x == y的值为true )时,此方法返回true

请注意,无论何时覆盖此方法,通常都需要覆盖 hashCode方法,以维护 hashCode方法的一般合同,该方法声明相等对象必须具有相同的散列代码。

Parameters
obj Object: the reference object with which to compare.
Returns
boolean true if this object is the same as the obj argument; false otherwise.

getAvailableLocales

Added in API level 24
Locale[] getAvailableLocales ()

返回 getInstance方法可返回本地化实例的所有语言环境的数组。

注意:java.text.DecimalFormatSymbols#getAvailableLocales不同,此方法仅返回可用于此类的Locale的数组。 ICU目前不支持Java 6中引入的DecimalFormatSymbolsProvider

Returns
Locale[] An array of Locales for which localized DecimalFormatSymbols instances are available.

getCurrency

Added in API level 24
Currency getCurrency ()

返回货币符号,仅适用于getCurrency() API兼容性。 ICU客户应该直接使用货币API。

Returns
Currency the currency used, or null

getCurrencySymbol

Added in API level 24
String getCurrencySymbol ()

返回表示本地货币的字符串。

Returns
String the local currency String.

getDecimalSeparator

Added in API level 24
char getDecimalSeparator ()

返回用于十进制符号的字符。 法国等不同

Returns
char the decimal character

getDigit

Added in API level 24
char getDigit ()

返回模式中用于数字的字符。

Returns
char the digit pattern character

getDigits

Added in API level 24
char[] getDigits ()

按照从0到9的顺序返回用作数字的字符数组

Returns
char[] The array

getExponentMultiplicationSign

Added in API level 24
String getExponentMultiplicationSign ()

返回乘号

Returns
String

getExponentSeparator

Added in API level 24
String getExponentSeparator ()

[icu]返回用于将尾数与指数分开的字符串。 例如:1.23x104的“x10 ^”,1.23E4的“E”。

Returns
String the localized exponent symbol, used in localized patterns and formatted strings

也可以看看:

getGroupingSeparator

Added in API level 24
char getGroupingSeparator ()

返回用于千位分隔符的字符。 法国等不同

Returns
char the thousands character

getInfinity

Added in API level 24
String getInfinity ()

返回用于表示无穷大的字符串。 几乎总是保持不变。

Returns
String the Infinity string

getInstance

Added in API level 24
DecimalFormatSymbols getInstance ()

返回默认语言环境的DecimalFormatSymbols实例。

注意:java.text.DecimalFormatSymbols#getInstance不同,此方法仅返回new android.icu.text.DecimalFormatSymbols() ICU目前不支持Java 6中引入的DecimalFormatSymbolsProvider

Returns
DecimalFormatSymbols A DecimalFormatSymbols instance.

getInstance

Added in API level 24
DecimalFormatSymbols getInstance (Locale locale)

返回给定语言环境的DecimalFormatSymbols实例。

注意:java.text.DecimalFormatSymbols#getInstance不同,此方法仅返回new android.icu.text.DecimalFormatSymbols(locale) ICU目前不支持Java 6中引入的DecimalFormatSymbolsProvider

Parameters
locale Locale: the locale.
Returns
DecimalFormatSymbols A DecimalFormatSymbols instance.

getInstance

Added in API level 24
DecimalFormatSymbols getInstance (ULocale locale)

返回给定语言环境的DecimalFormatSymbols实例。

注意:java.text.DecimalFormatSymbols#getInstance不同,此方法仅返回new android.icu.text.DecimalFormatSymbols(locale) ICU目前不支持Java 6中引入的DecimalFormatSymbolsProvider

Parameters
locale ULocale: the locale.
Returns
DecimalFormatSymbols A DecimalFormatSymbols instance.

getInternationalCurrencySymbol

Added in API level 24
String getInternationalCurrencySymbol ()

返回表示本地货币的国际字符串。

Returns
String the international string denoting the local currency

getLocale

Added in API level 24
Locale getLocale ()

返回构造此对象的语言环境。

Returns
Locale the locale for which this object was constructed

getMinusSign

Added in API level 24
char getMinusSign ()

返回用于表示减号的字符。 如果没有指定明确的否定格式,则通过将minusSign前缀到正格式来形成一个格式。

Returns
char the minus sign character

getMonetaryDecimalSeparator

Added in API level 24
char getMonetaryDecimalSeparator ()

返回货币小数点分隔符。

Returns
char the monetary decimal separator character

getMonetaryGroupingSeparator

Added in API level 24
char getMonetaryGroupingSeparator ()

[icu]返回货币分组分隔符。

Returns
char the monetary grouping separator character

getNaN

Added in API level 24
String getNaN ()

返回用于表示NaN的字符串。 几乎总是保持不变。

Returns
String the NaN String

getPadEscape

Added in API level 24
char getPadEscape ()

[icu]返回用于将数字填充到指定宽度的字符。 这不是填充字符本身; 相反,它是填充字符前面的特殊模式字符。 在模式“* _#,## 0”中,'*'是填充符转义符,'_'是填充符。

Returns
char the character

也可以看看:

getPatternForCurrencySpacing

Added in API level 24
String getPatternForCurrencySpacing (int itemType, 
                boolean beforeCurrency)

[icu]返回所需的货币间隔值。 原始值来自ICU的CLDR数据,基于在施工期间提供的区域设置,可以为空。 这些值决定了格式化货币时在货币代码/名称/符号和货币金额之间插入文本的时间和时间。

有关更多信息,请参阅 UTS#35 section 5.10.2

注意: ICU4J目前不使用此信息。

Parameters
itemType int: one of CURRENCY_SPC_CURRENCY_MATCH, CURRENCY_SPC_SURROUNDING_MATCH or CURRENCY_SPC_INSERT
beforeCurrency boolean: true to get the beforeCurrency values, false to get the afterCurrency values.
Returns
String the value, or null.

也可以看看:

getPatternSeparator

Added in API level 24
char getPatternSeparator ()

返回用于在模式中分隔正和负子模式的字符。

Returns
char the pattern separator character

getPerMill

Added in API level 24
char getPerMill ()

返回用于百分号的字符。 阿拉伯语等不同

Returns
char the mille percent character

getPercent

Added in API level 24
char getPercent ()

返回用于百分号的字符。 阿拉伯语等不同

Returns
char the percent character

getPlusSign

Added in API level 24
char getPlusSign ()

[icu]返回局部加号。

Returns
char the plus sign, used in localized patterns and formatted strings

也可以看看:

getSignificantDigit

Added in API level 24
char getSignificantDigit ()

返回用于表示模式中有效数字的字符。

Returns
char the significant digit pattern character

getULocale

Added in API level 24
ULocale getULocale ()

返回构造此对象的语言环境。

Returns
ULocale the locale for which this object was constructed

getZeroDigit

Added in API level 24
char getZeroDigit ()

返回用于零的字符。 阿拉伯语等不同

Returns
char the character

hashCode

Added in API level 24
int hashCode ()

返回对象的哈希码值。 为了散列表的好处而支持此方法,例如由HashMap提供的HashMap

hashCode的总合同是:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

尽可能合理实用,类Object定义的hashCode方法确实为不同的对象返回不同的整数。 (这通常通过将对象的内部地址转换为整数来实现,但Java TM编程语言不需要此实现技术。)

Returns
int a hash code value for this object.

setCurrency

Added in API level 24
void setCurrency (Currency currency)

设置货币。

注意: ICU不再使用DecimalFormatSymbols作为货币。 该API仅用于API兼容性。

这还将货币符号属性设置为DecimalFormatSymbols区域设置中的货币符号,将国际货币符号属性设置为货币的ISO 4217货币代码。

Parameters
currency Currency: the new currency to be used
Throws
NullPointerException if currency is null

也可以看看:

setCurrencySymbol

Added in API level 24
void setCurrencySymbol (String currency)

设置表示本地货币的字符串。

Parameters
currency String: the local currency String.

setDecimalSeparator

Added in API level 24
void setDecimalSeparator (char decimalSeparator)

设置用于十进制符号的字符。 法国等不同

Parameters
decimalSeparator char: the decimal character

setDigit

Added in API level 24
void setDigit (char digit)

设置模式中用于数字的字符。

Parameters
digit char: the digit pattern character

setExponentMultiplicationSign

Added in API level 24
void setExponentMultiplicationSign (String exponentMultiplicationSign)

设置乘号

Parameters
exponentMultiplicationSign String

setExponentSeparator

Added in API level 24
void setExponentSeparator (String exp)

[icu]设置用于将尾数与指数分开的字符串。 例如:1.23x104的“x10 ^”,1.23E4的“E”。

Parameters
exp String: the localized exponent symbol, used in localized patterns and formatted strings

也可以看看:

setGroupingSeparator

Added in API level 24
void setGroupingSeparator (char groupingSeparator)

设置用于千位分隔符的字符。 法国等不同

Parameters
groupingSeparator char: the thousands character

setInfinity

Added in API level 24
void setInfinity (String infinity)

设置用于表示无穷大的字符串。 几乎总是保持不变。

Parameters
infinity String: the Infinity String

setInternationalCurrencySymbol

Added in API level 24
void setInternationalCurrencySymbol (String currency)

设置表示本地货币的国际字符串。

Parameters
currency String: the international string denoting the local currency.

setMinusSign

Added in API level 24
void setMinusSign (char minusSign)

设置用于表示减号的字符。 如果没有指定明确的否定格式,则通过将minusSign前缀到正格式来形成一个格式。

Parameters
minusSign char: the minus sign character

setMonetaryDecimalSeparator

Added in API level 24
void setMonetaryDecimalSeparator (char sep)

设置货币小数点分隔符。

Parameters
sep char: the monetary decimal separator character

setMonetaryGroupingSeparator

Added in API level 24
void setMonetaryGroupingSeparator (char sep)

设置货币小数点分隔符。

Parameters
sep char: the monetary decimal separator character

setNaN

Added in API level 24
void setNaN (String NaN)

设置用于表示NaN的字符串。 几乎总是保持不变。

Parameters
NaN String: the NaN String

setPadEscape

Added in API level 24
void setPadEscape (char c)

[icu]设置用于将数字填充到指定宽度的字符。 这不是填充字符本身; 相反,它是填充字符前面的特殊模式字符。 在模式“* _#,## 0”中,'*'是填充符转义符,'_'是填充符。

Parameters
c char

也可以看看:

setPatternForCurrencySpacing

Added in API level 24
void setPatternForCurrencySpacing (int itemType, 
                boolean beforeCurrency, 
                String pattern)

[icu]设置指示的货币间隔模式或值。 有关更多信息,请参阅getPatternForCurrencySpacing(int, boolean)

货币匹配和周边匹配的值必须为UnicodeSet模式。 插入的值可以是任何字符串。

注意: ICU4J目前不使用此信息。

Parameters
itemType int: one of CURRENCY_SPC_CURRENCY_MATCH, CURRENCY_SPC_SURROUNDING_MATCH or CURRENCY_SPC_INSERT
beforeCurrency boolean: true if the pattern is for before the currency symbol. false if the pattern is for after it.
pattern String: string to override current setting; can be null.

也可以看看:

setPatternSeparator

Added in API level 24
void setPatternSeparator (char patternSeparator)

设置用于在模式中分隔正面和负面子模式的字符。

Parameters
patternSeparator char: the pattern separator character

setPerMill

Added in API level 24
void setPerMill (char perMill)

设置用于千分比符号的字符。 阿拉伯语等不同

Parameters
perMill char: the mille percent character

setPercent

Added in API level 24
void setPercent (char percent)

设置用于百分号的字符。 阿拉伯语等不同

Parameters
percent char: the percent character

setPlusSign

Added in API level 24
void setPlusSign (char plus)

[icu]设置局部加号。

Parameters
plus char: the plus sign, used in localized patterns and formatted strings

也可以看看:

setSignificantDigit

Added in API level 24
void setSignificantDigit (char sigDigit)

设置用于表示模式中有效数字的字符。

Parameters
sigDigit char: the significant digit pattern character

setZeroDigit

Added in API level 24
void setZeroDigit (char zeroDigit)

设置用于零的字符。

Parameters
zeroDigit char: the zero character.

Hooray!