public final class Currency
extends Object implements Serializable
| java.lang.Object | |
| ↳ | java.util.Currency |
代表货币。 货币通过其ISO 4217货币代码进行标识。 请访问ISO web site了解更多信息，包括货币代码表。
该课程旨在确保任何给定货币不会有多个Currency实例。 因此，没有公共构造函数。 您使用getInstance方法获得Currency实例。
用户可以通过创建名为<JAVA_HOME>/lib/currency.properties的属性文件来取代Java运行时货币数据。 属性文件的内容分别是ISO 3166国家代码和ISO 4217货币数据的键/值对。 值部分由货币的三个ISO 4217值组成，即字母代码，数字代码和次要单位。 这三个ISO 4217值用逗号分隔。 以'＃'开头的行被视为注释行。 例如，
#Sample currency properties
JP=JPZ,999,0
将取代日本的货币数据。
Public methods |
|
|---|---|
static Set<Currency> |
getAvailableCurrencies() 获取可用货币的集合。 |
String |
getCurrencyCode() 获取此货币的ISO 4217货币代码。 |
int |
getDefaultFractionDigits() 获取此货币使用的默认小数位数。 |
String |
getDisplayName() 获取适用于显示默认语言环境的货币的名称。 |
String |
getDisplayName(Locale locale) 获取适用于显示指定语言环境的货币的名称。 |
static Currency |
getInstance(String currencyCode) 返回给定货币代码的 |
static Currency |
getInstance(Locale locale) 返回给定语言环境的国家/地区的 |
int |
getNumericCode() 返回此货币的ISO 4217数字代码。 |
String |
getSymbol(Locale locale) 获取指定语言环境的此货币符号。 |
String |
getSymbol() 获取默认语言环境的此货币符号。 |
String |
toString() 返回此货币的ISO 4217货币代码。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
Set<Currency> getAvailableCurrencies ()
获取可用货币的集合。 返回的一组货币包含所有可用货币，其中可能包括代表过时ISO 4217代码的货币。 该集可以在不影响运行时可用货币的情况下进行修改。
| Returns | |
|---|---|
Set<Currency> |
the set of available currencies. If there is no currency available in the runtime, the returned set is empty. |
String getCurrencyCode ()
获取此货币的ISO 4217货币代码。
| Returns | |
|---|---|
String |
the ISO 4217 currency code of this currency. |
int getDefaultFractionDigits ()
获取此货币使用的默认小数位数。 例如，欧元的默认小数位数为2，而日元则为0.在伪币等情况下，如IMF特殊提款权，则返回-1。
| Returns | |
|---|---|
int |
the default number of fraction digits used with this currency |
String getDisplayName ()
获取适用于显示默认语言环境的货币的名称。 如果在缺省语言环境中找不到合适的显示名称，则返回ISO 4217货币代码。
| Returns | |
|---|---|
String |
the display name of this currency for the default locale |
String getDisplayName (Locale locale)
获取适用于显示指定语言环境的货币的名称。 如果没有为指定区域设置找到合适的显示名称，则返回ISO 4217货币代码。
| Parameters | |
|---|---|
locale |
Locale: the locale for which a display name for this currency is needed |
| Returns | |
|---|---|
String |
the display name of this currency for the specified locale |
| Throws | |
|---|---|
NullPointerException |
if locale is null |
Currency getInstance (String currencyCode)
返回给定货币代码的 Currency实例。
| Parameters | |
|---|---|
currencyCode |
String: the ISO 4217 code of the currency |
| Returns | |
|---|---|
Currency |
the Currency instance for the given currency code |
| Throws | |
|---|---|
NullPointerException |
if currencyCode is null |
IllegalArgumentException |
if currencyCode is not a supported ISO 4217 code. |
Currency getInstance (Locale locale)
返回给定语言环境国家的Currency实例。 语言环境的语言和变体组件被忽略。 随着各国改变其货币，结果可能会随时间而变化。 例如，对于欧洲货币联盟的原始成员国，该方法将旧国家货币返回至2001年12月31日，而欧元则从2002年1月1日起，即各国当地时间。
该方法为没有货币的地区返回 null ，如南极洲。
| Parameters | |
|---|---|
locale |
Locale: the locale for whose country a Currency instance is needed |
| Returns | |
|---|---|
Currency |
the Currency instance for the country of the given locale, or null |
| Throws | |
|---|---|
NullPointerException |
if locale or its country code is null |
IllegalArgumentException |
if the country of the given locale is not a supported ISO 3166 country code. |
int getNumericCode ()
返回此货币的ISO 4217数字代码。
| Returns | |
|---|---|
int |
the ISO 4217 numeric code of this currency |
String getSymbol (Locale locale)
获取指定语言环境的此货币符号。 例如，对于美元，如果指定区域设置为美国，则符号为“$”，而对于其他区域设置，则可以是“美元”。 如果没有符号可以确定，则返回ISO 4217货币代码。
| Parameters | |
|---|---|
locale |
Locale: the locale for which a display name for this currency is needed |
| Returns | |
|---|---|
String |
the symbol of this currency for the specified locale |
| Throws | |
|---|---|
NullPointerException |
if locale is null |
String getSymbol ()
获取默认语言环境的此货币符号。 例如，对于美元，如果默认区域设置为美国，则符号为“$”，而对于其他区域设置，可以是“美元”。 如果没有符号可以确定，则返回ISO 4217货币代码。
| Returns | |
|---|---|
String |
the symbol of this currency for the default locale |
String toString ()
返回此货币的ISO 4217货币代码。
| Returns | |
|---|---|
String |
the ISO 4217 currency code of this currency |
Android开发手册