JavaTM Platform
Standard Ed. 6

java.text
类 DecimalFormatSymbols

java.lang.Object
  继承者 java.text.DecimalFormatSymbols
所有已实现的接口:
Serializable, Cloneable

public class DecimalFormatSymbols
extends Object
implements Cloneable, Serializable

此类表示了 DecimalFormat 格式化数字所需的符号集(如小数点、组分隔符等等)。DecimalFormat 根据其语言环境数据为其自身创建一个 DecimalFormatSymbols 实例。如果需要更改这些符号,可从 DecimalFormat 获得 DecimalFormatSymbols 对象并修改它。

另请参见:
Locale, DecimalFormat, 序列化表格

构造方法摘要
DecimalFormatSymbols()
          为默认的语言环境创建一个 DecimalFormatSymbols 对象。
DecimalFormatSymbols(Locale locale)
          为给定的语言环境创建一个 DecimalFormatSymbols 对象。
 
方法摘要
 Object clone()
          标准重写。
 boolean equals(Object obj)
          重写 equals。
static Locale[] getAvailableLocales()
          返回一个数组,它包括所有此类的 getInstance 方法可为之返回本地化实例的语言环境。
 Currency getCurrency()
          获得这些 DecimalFormatSymbols 的货币。
 String getCurrencySymbol()
          返回这些 DecimalFormatSymbols 货币在其语言环境中的货币符号。
 char getDecimalSeparator()
          获得用于十进制符号的字符。
 char getDigit()
          获得用于某种模式中数字的字符。
 String getExponentSeparator()
          返回用于分隔尾数和指数的字符串。
 char getGroupingSeparator()
          获得用于千位分隔符的字符。
 String getInfinity()
          获得用于表示无穷大的字符串。
static DecimalFormatSymbols getInstance()
          获取默认语言环境的 DecimalFormatSymbols 实例。
static DecimalFormatSymbols getInstance(Locale locale)
          获取指定语言环境的 DecimalFormatSymbols 实例。
 String getInternationalCurrencySymbol()
          返回这些 DecimalFormatSymbols 货币的 ISO 4217 货币代码。
 char getMinusSign()
          获得用于表示减号的字符。
 char getMonetaryDecimalSeparator()
          返回货币小数点分隔符。
 String getNaN()
          获得用于表示“非数字”的字符串。
 char getPatternSeparator()
          获得用于在模式中分隔正数和负数子模式的字符。
 char getPercent()
          获得用于百分数符号的字符。
 char getPerMill()
          获得用于千分数符号的字符。
 char getZeroDigit()
          获得用于零的字符。
 int hashCode()
          重写 hashCode。
 void setCurrency(Currency currency)
          设置这些 DecimalFormatSymbols 的货币。
 void setCurrencySymbol(String currency)
          设置这些 DecimalFormatSymbols 货币在其语言环境中的货币符号。
 void setDecimalSeparator(char decimalSeparator)
          设置用于十进制符号的字符。
 void setDigit(char digit)
          设置用于某种模式中数字的字符。
 void setExponentSeparator(String exp)
          设置用于分隔尾数和指数的字符串。
 void setGroupingSeparator(char groupingSeparator)
          设置用于千位分隔符的字符。
 void setInfinity(String infinity)
          设置用于表示无穷大的字符串。
 void setInternationalCurrencySymbol(String currencyCode)
          设置这些 DecimalFormatSymbols 货币的 ISO 4217 货币代码。
 void setMinusSign(char minusSign)
          设置用于表示减号的字符。
 void setMonetaryDecimalSeparator(char sep)
          设置货币小数点分隔符。
 void setNaN(String NaN)
          设置用于表示“非数字”的字符串。
 void setPatternSeparator(char patternSeparator)
          设置用于在模式中分隔正数和负数子模式的字符。
 void setPercent(char percent)
          设置用于百分数符号的字符。
 void setPerMill(char perMill)
          设置用于千分数符号的字符。
 void setZeroDigit(char zeroDigit)
          设置用于零的字符。
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

DecimalFormatSymbols

public DecimalFormatSymbols()
为默认的语言环境创建一个 DecimalFormatSymbols 对象。此构造方法只能为 Java 运行时环境所支持的语言环境构造实例,而不能为那些已安装的 DecimalFormatSymbolsProvider 实现所支持的语言环境构造实例。要覆盖所有语言环境,请使用 getInstance 方法。


DecimalFormatSymbols

public DecimalFormatSymbols(Locale locale)
为给定的语言环境创建一个 DecimalFormatSymbols 对象。此构造方法只能为 Java 运行时环境所支持的语言环境构造实例,而不能为那些已安装的 DecimalFormatSymbolsProvider 实现所支持的语言环境构造实例。要覆盖所有语言环境,请使用 getInstance 方法。

抛出:
NullPointerException - 如果 locale 为 null
方法详细信息

getAvailableLocales

public static Locale[] getAvailableLocales()
返回一个数组,它包括所有此类的 getInstance 方法可为之返回本地化实例的语言环境。返回的数组表示 Java 运行时和已安装的 DecimalFormatSymbolsProvider 实现所支持的语言环境的并集。返回的数组必须至少包含一个等同于 Locale.USLocale 实例。

返回:
可获得其本地化 DecimalFormatSymbols 实例的语言环境数组。
从以下版本开始:
1.6

getInstance

public static final DecimalFormatSymbols getInstance()
获取默认语言环境的 DecimalFormatSymbols 实例。此方法为 Java 运行时本身以及已安装的 DecimalFormatSymbolsProvider 实现所支持的语言环境提供对 DecimalFormatSymbols 实例的访问。

返回:
一个 DecimalFormatSymbols 实例。
从以下版本开始:
1.6

getInstance

public static final DecimalFormatSymbols getInstance(Locale locale)
获取指定语言环境的 DecimalFormatSymbols 实例。此方法为 Java 运行时本身以及已安装的 DecimalFormatSymbolsProvider 实现所支持的语言环境提供对 DecimalFormatSymbols 实例的访问。

参数:
locale - 所需的语言环境。
返回:
一个 DecimalFormatSymbols 实例。
抛出:
NullPointerException - 如果 locale 为 null
从以下版本开始:
1.6

getZeroDigit

public char getZeroDigit()
获得用于零的字符。用于阿拉伯语等的该字符不同。


setZeroDigit

public void setZeroDigit(char zeroDigit)
设置用于零的字符。用于阿拉伯语等的该字符不同。


getGroupingSeparator

public char getGroupingSeparator()
获得用于千位分隔符的字符。用于法语等的该字符不同。


setGroupingSeparator

public void setGroupingSeparator(char groupingSeparator)
设置用于千位分隔符的字符。用于法语等的该字符不同。


getDecimalSeparator

public char getDecimalSeparator()
获得用于十进制符号的字符。用于法语等的该字符不同。


setDecimalSeparator

public void setDecimalSeparator(char decimalSeparator)
设置用于十进制符号的字符。用于法语等的该字符不同。


getPerMill

public char getPerMill()
获得用于千分数符号的字符。用于阿拉伯语等的该字符不同。


setPerMill

public void setPerMill(char perMill)
设置用于千分数符号的字符。用于阿拉伯语等的该字符不同。


getPercent

public char getPercent()
获得用于百分数符号的字符。用于阿拉伯语等的该字符不同。


setPercent

public void setPercent(char percent)
设置用于百分数符号的字符。用于阿拉伯语等的该字符不同。


getDigit

public char getDigit()
获得用于某种模式中数字的字符。


setDigit

public void setDigit(char digit)
设置用于某种模式中数字的字符。


getPatternSeparator

public char getPatternSeparator()
获得用于在模式中分隔正数和负数子模式的字符。


setPatternSeparator

public void setPatternSeparator(char patternSeparator)
设置用于在模式中分隔正数和负数子模式的字符。


getInfinity

public String getInfinity()
获得用于表示无穷大的字符串。几乎总是保持不变。


setInfinity

public void setInfinity(String infinity)
设置用于表示无穷大的字符串。几乎总是保持不变。


getNaN

public String getNaN()
获得用于表示“非数字”的字符串。几乎总是保持不变。


setNaN

public void setNaN(String NaN)
设置用于表示“非数字”的字符串。几乎总是保持不变。


getMinusSign

public char getMinusSign()
获得用于表示减号的字符。如果未指定显式的负数格式,则通过将 minusSign 作为正数格式的前缀来形成一个负数格式。


setMinusSign

public void setMinusSign(char minusSign)
设置用于表示减号的字符。如果未指定显式的负数格式,则通过将 minusSign 作为正数格式的前缀来形成一个负数格式。


getCurrencySymbol

public String getCurrencySymbol()
返回这些 DecimalFormatSymbols 货币在其语言环境中的货币符号。

从以下版本开始:
1.2

setCurrencySymbol

public void setCurrencySymbol(String currency)
设置这些 DecimalFormatSymbols 货币在其语言环境中的货币符号。

从以下版本开始:
1.2

getInternationalCurrencySymbol

public String getInternationalCurrencySymbol()
返回这些 DecimalFormatSymbols 货币的 ISO 4217 货币代码。

从以下版本开始:
1.2

setInternationalCurrencySymbol

public void setInternationalCurrencySymbol(String currencyCode)
设置这些 DecimalFormatSymbols 货币的 ISO 4217 货币代码。如果货币代码有效(如 Currency.getInstance 所定义的),则此方法还为相应的 Currency 实例设置货币属性,并为 DecimalFormatSymbols 语言环境中的货币符号设置货币符号属性。如果货币代码无效,则将货币属性设置为 null,并且不修改货币符号属性。

从以下版本开始:
1.2
另请参见:
setCurrency(java.util.Currency), setCurrencySymbol(java.lang.String)

getCurrency

public Currency getCurrency()
获得这些 DecimalFormatSymbols 的货币。如果以前将货币符号属性设置为不是有效 ISO 4217 货币代码的值,则可能为 null。

返回:
使用的货币,或者为 null
从以下版本开始:
1.4

setCurrency

public void setCurrency(Currency currency)
设置这些 DecimalFormatSymbols 的货币。这还为 DecimalFormatSymbols 语言环境中的货币符号设置了货币符号属性,并为该货币的 ISO 4217 货币代码设置了国际货币符号。

参数:
currency - 要使用的新货币
抛出:
NullPointerException - 如果 currency 为 null
从以下版本开始:
1.4
另请参见:
setCurrencySymbol(java.lang.String), setInternationalCurrencySymbol(java.lang.String)

getMonetaryDecimalSeparator

public char getMonetaryDecimalSeparator()
返回货币小数点分隔符。

从以下版本开始:
1.2

setMonetaryDecimalSeparator

public void setMonetaryDecimalSeparator(char sep)
设置货币小数点分隔符。

从以下版本开始:
1.2

getExponentSeparator

public String getExponentSeparator()
返回用于分隔尾数和指数的字符串。示例:1.23x10^4 中的 "x10^",1.23E4 中的 "E" 。

返回:
指数分隔符字符串
从以下版本开始:
1.6
另请参见:
setExponentSeparator(java.lang.String)

setExponentSeparator

public void setExponentSeparator(String exp)
设置用于分隔尾数和指数的字符串。示例:1.23x10^4 中的 "x10^",1.23E4 中的 "E" 。

参数:
exp - 指数分隔符字符串
抛出:
NullPointerException - 如果 exp 为 null
从以下版本开始:
1.6
另请参见:
getExponentSeparator()

clone

public Object clone()
标准重写。

覆盖:
Object 中的 clone
返回:
此实例的一个副本。
另请参见:
Cloneable

equals

public boolean equals(Object obj)
重写 equals。

覆盖:
Object 中的 equals
参数:
obj - 要与之比较的引用对象。
返回:
如果此对象与 obj 参数相同,则返回 true;否则返回 false
另请参见:
Object.hashCode(), Hashtable

hashCode

public int hashCode()
重写 hashCode。

覆盖:
Object 中的 hashCode
返回:
此对象的一个哈希码值。
另请参见:
Object.equals(java.lang.Object), Hashtable

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策