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
对象并对其进行修改。
也可以看看:
Constants |
|
---|---|
int |
CURRENCY_SPC_CURRENCY_MATCH [icu]表示 |
int |
CURRENCY_SPC_INSERT [icu]表示 |
int |
CURRENCY_SPC_SURROUNDING_MATCH [icu]表示 |
Public constructors |
|
---|---|
DecimalFormatSymbols() 为默认的 |
|
DecimalFormatSymbols(Locale locale) 为给定的语言环境创建DecimalFormatSymbols对象。 |
|
DecimalFormatSymbols(ULocale locale) [icu]为给定语言环境创建DecimalFormatSymbols对象。 |
Public methods |
|
---|---|
Object |
clone() 创建并返回此对象的副本。 |
boolean |
equals(Object obj) 指示其他某个对象是否“等于”这一个。 |
static Locale[] |
getAvailableLocales() 返回 |
Currency |
getCurrency() 返回货币符号,仅适用于 |
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
|
int CURRENCY_SPC_CURRENCY_MATCH
[icu]表示 getPatternForCurrencySpacing(int, boolean)
使用的货币匹配模式。
常量值:0(0x00000000)
int CURRENCY_SPC_INSERT
[icu]表示 getPatternForCurrencySpacing(int, boolean)
使用的插入值。
常量值:2(0x00000002)
int CURRENCY_SPC_SURROUNDING_MATCH
[icu]表示 getPatternForCurrencySpacing(int, boolean)
使用的周边匹配模式。
常数值:1(0x00000001)
DecimalFormatSymbols ()
为默认的 FORMAT
语言环境创建DecimalFormatSymbols对象。
也可以看看:
DecimalFormatSymbols (Locale locale)
为给定的语言环境创建DecimalFormatSymbols对象。
Parameters | |
---|---|
locale |
Locale : the locale |
DecimalFormatSymbols (ULocale locale)
[icu]为给定语言环境创建DecimalFormatSymbols对象。
Parameters | |
---|---|
locale |
ULocale : the locale |
Object clone ()
创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是,对于任何对象x
,表达式:
will be true, and that the expression:x.clone() != x
will bex.clone().getClass() == x.getClass()
true
, but these are not absolute requirements. While it is typically the case that:
will bex.clone().equals(x)
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. |
boolean equals (Object obj)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. 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. x
, x.equals(null)
should return false
. 类equals
方法Object
实现了对象上最可能的等价关系; 也就是说,对于任何非空参考值x
和y
,当且仅当x
和y
引用同一对象( 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. |
Locale[] getAvailableLocales ()
返回 getInstance
方法可返回本地化实例的所有语言环境的数组。
注意:与java.text.DecimalFormatSymbols#getAvailableLocales
不同,此方法仅返回可用于此类的Locale
的数组。 ICU目前不支持Java 6中引入的DecimalFormatSymbolsProvider
。
Returns | |
---|---|
Locale[] |
An array of Locale s for which localized DecimalFormatSymbols instances are available. |
Currency getCurrency ()
返回货币符号,仅适用于getCurrency()
API兼容性。 ICU客户应该直接使用货币API。
Returns | |
---|---|
Currency |
the currency used, or null |
String getCurrencySymbol ()
返回表示本地货币的字符串。
Returns | |
---|---|
String |
the local currency String. |
char getDecimalSeparator ()
返回用于十进制符号的字符。 法国等不同
Returns | |
---|---|
char |
the decimal character |
char getDigit ()
返回模式中用于数字的字符。
Returns | |
---|---|
char |
the digit pattern character |
String getExponentMultiplicationSign ()
返回乘号
Returns | |
---|---|
String |
String getExponentSeparator ()
[icu]返回用于将尾数与指数分开的字符串。 例如:1.23x104的“x10 ^”,1.23E4的“E”。
Returns | |
---|---|
String |
the localized exponent symbol, used in localized patterns and formatted strings |
也可以看看:
char getGroupingSeparator ()
返回用于千位分隔符的字符。 法国等不同
Returns | |
---|---|
char |
the thousands character |
String getInfinity ()
返回用于表示无穷大的字符串。 几乎总是保持不变。
Returns | |
---|---|
String |
the Infinity string |
DecimalFormatSymbols getInstance ()
返回默认语言环境的DecimalFormatSymbols实例。
注意:与java.text.DecimalFormatSymbols#getInstance
不同,此方法仅返回new android.icu.text.DecimalFormatSymbols()
。 ICU目前不支持Java 6中引入的DecimalFormatSymbolsProvider
。
Returns | |
---|---|
DecimalFormatSymbols |
A DecimalFormatSymbols instance. |
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. |
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. |
String getInternationalCurrencySymbol ()
返回表示本地货币的国际字符串。
Returns | |
---|---|
String |
the international string denoting the local currency |
Locale getLocale ()
返回构造此对象的语言环境。
Returns | |
---|---|
Locale |
the locale for which this object was constructed |
char getMinusSign ()
返回用于表示减号的字符。 如果没有指定明确的否定格式,则通过将minusSign前缀到正格式来形成一个格式。
Returns | |
---|---|
char |
the minus sign character |
char getMonetaryDecimalSeparator ()
返回货币小数点分隔符。
Returns | |
---|---|
char |
the monetary decimal separator character |
char getMonetaryGroupingSeparator ()
[icu]返回货币分组分隔符。
Returns | |
---|---|
char |
the monetary grouping separator character |
String getNaN ()
返回用于表示NaN的字符串。 几乎总是保持不变。
Returns | |
---|---|
String |
the NaN String |
char getPadEscape ()
[icu]返回用于将数字填充到指定宽度的字符。 这不是填充字符本身; 相反,它是填充字符前面的特殊模式字符。 在模式“* _#,## 0”中,'*'是填充符转义符,'_'是填充符。
Returns | |
---|---|
char |
the character |
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. |
char getPatternSeparator ()
返回用于在模式中分隔正和负子模式的字符。
Returns | |
---|---|
char |
the pattern separator character |
char getPerMill ()
返回用于百分号的字符。 阿拉伯语等不同
Returns | |
---|---|
char |
the mille percent character |
char getPercent ()
返回用于百分号的字符。 阿拉伯语等不同
Returns | |
---|---|
char |
the percent character |
char getPlusSign ()
[icu]返回局部加号。
Returns | |
---|---|
char |
the plus sign, used in localized patterns and formatted strings |
char getSignificantDigit ()
返回用于表示模式中有效数字的字符。
Returns | |
---|---|
char |
the significant digit pattern character |
ULocale getULocale ()
返回构造此对象的语言环境。
Returns | |
---|---|
ULocale |
the locale for which this object was constructed |
char getZeroDigit ()
返回用于零的字符。 阿拉伯语等不同
Returns | |
---|---|
char |
the character |
int hashCode ()
返回对象的哈希码值。 为了散列表的好处而支持此方法,例如由HashMap
提供的HashMap
。
hashCode
的总合同是:
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. equals(Object)
method, then calling the hashCode
method on each of the two objects must produce the same integer result. 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. |
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 |
void setCurrencySymbol (String currency)
设置表示本地货币的字符串。
Parameters | |
---|---|
currency |
String : the local currency String. |
void setDecimalSeparator (char decimalSeparator)
设置用于十进制符号的字符。 法国等不同
Parameters | |
---|---|
decimalSeparator |
char : the decimal character |
void setDigit (char digit)
设置模式中用于数字的字符。
Parameters | |
---|---|
digit |
char : the digit pattern character |
void setExponentMultiplicationSign (String exponentMultiplicationSign)
设置乘号
Parameters | |
---|---|
exponentMultiplicationSign |
String
|
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 |
也可以看看:
void setGroupingSeparator (char groupingSeparator)
设置用于千位分隔符的字符。 法国等不同
Parameters | |
---|---|
groupingSeparator |
char : the thousands character |
void setInfinity (String infinity)
设置用于表示无穷大的字符串。 几乎总是保持不变。
Parameters | |
---|---|
infinity |
String : the Infinity String |
void setInternationalCurrencySymbol (String currency)
设置表示本地货币的国际字符串。
Parameters | |
---|---|
currency |
String : the international string denoting the local currency. |
void setMinusSign (char minusSign)
设置用于表示减号的字符。 如果没有指定明确的否定格式,则通过将minusSign前缀到正格式来形成一个格式。
Parameters | |
---|---|
minusSign |
char : the minus sign character |
void setMonetaryDecimalSeparator (char sep)
设置货币小数点分隔符。
Parameters | |
---|---|
sep |
char : the monetary decimal separator character |
void setMonetaryGroupingSeparator (char sep)
设置货币小数点分隔符。
Parameters | |
---|---|
sep |
char : the monetary decimal separator character |
void setNaN (String NaN)
设置用于表示NaN的字符串。 几乎总是保持不变。
Parameters | |
---|---|
NaN |
String : the NaN String |
void setPadEscape (char c)
[icu]设置用于将数字填充到指定宽度的字符。 这不是填充字符本身; 相反,它是填充字符前面的特殊模式字符。 在模式“* _#,## 0”中,'*'是填充符转义符,'_'是填充符。
Parameters | |
---|---|
c |
char
|
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. |
void setPatternSeparator (char patternSeparator)
设置用于在模式中分隔正面和负面子模式的字符。
Parameters | |
---|---|
patternSeparator |
char : the pattern separator character |
void setPerMill (char perMill)
设置用于千分比符号的字符。 阿拉伯语等不同
Parameters | |
---|---|
perMill |
char : the mille percent character |
void setPercent (char percent)
设置用于百分号的字符。 阿拉伯语等不同
Parameters | |
---|---|
percent |
char : the percent character |
void setPlusSign (char plus)
[icu]设置局部加号。
Parameters | |
---|---|
plus |
char : the plus sign, used in localized patterns and formatted strings |
void setSignificantDigit (char sigDigit)
设置用于表示模式中有效数字的字符。
Parameters | |
---|---|
sigDigit |
char : the significant digit pattern character |
void setZeroDigit (char zeroDigit)
设置用于零的字符。
Parameters | |
---|---|
zeroDigit |
char : the zero character. |