compact1, compact2, compact3

java.util

Class Currency

java.lang.Object

java.util.Currency

All Implemented Interfaces:

Serializable

public final class Currency
extends Object
implements Serializable

表示一种货币。货币确定由他们的国际标准组织4217货币代码。参观 ISO web site更多信息。

课堂是这样设计的，从来没有超过一个Currency实例对于任何给定的货币。因此，没有公共构造函数。你得到一个Currency实例使用的getInstance方法。

用户可以取代java运行时货币数据系统的性能java.util.currency.data手段。如果这个系统属性被定义，那么它的值是一个属性文件的位置，其中的内容是关键/值对的等3166国代码和国际标准化组织4217货币数据分别。价值部分由一种货币，即三ISO 4217值，一个字母的代码，一个数字代码，和一个小的单元。三ISO 4217值用逗号分隔。该线开始的#的是注释行。一个可选的UTC时间戳可以指定每个货币进入如果用户需要指定一个割接日期显示新的数据时生效。时间戳追加到货币的最终性能和使用逗号作为分隔符。如果一个UTC邮戳是目前有效，JRE将只有当前的UTC日期晚于在类加载时指定的日期使用新货币的性质。“时间戳格式必须是ISO 8601格式：'yyyy-MM-dd'T'HH:mm:ss'。例如，

#Sample currency properties
JP=JPZ,999,0

日本将取代货币数据。

#Sample currency properties with cutover date
JP=JPZ,999,0,2014-01-01T00:00:00

将取代货币数据如果日本Currency类被加载后2014年1月1日00:00:00 GMT。

在句法上畸形的条目时，条目和条目忽略文件的剩余部分进行处理。在重复的国家代码的条目存在的情况下，该行为的货币信息，Currency定义，项目剩余文件处理。

从以下版本开始：

一点四

另请参见：

Serialized Form

方法摘要

Modifier and Type	Method and Description
static Set<Currency>	getAvailableCurrencies() 获取可用货币的集合。
String	getCurrencyCode() 获取此货币的国际标准化4217货币代码。
int	getDefaultFractionDigits() 获取此货币使用的小数位数的默认值。
String	getDisplayName() 而得名，适用于默认 DISPLAY现场显示该货币。
String	getDisplayName(Locale locale) 获取适合于为指定的区域设置显示该货币的名称。
static Currency	getInstance(Locale locale) 返回指定区域的国家 Currency实例。
static Currency	getInstance(String currencyCode) 返回指定货币代码的 Currency实例。
int	getNumericCode() 返回此货币的国际标准化组织4217数字代码。
String	getSymbol() 获取默认 DISPLAY现场这种货币符号。
String	getSymbol(Locale locale) 获取指定区域的此货币的符号。
String	toString() 返回此货币的国际标准化组织4217货币代码。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

方法详细信息

getInstance

public static Currency getInstance(String currencyCode)

返回指定货币代码的 Currency实例。

参数

currencyCode - ISO 4217货币代码的

结果

对于给定的货币代码的 Currency实例

异常

NullPointerException -如果 currencyCode是空的

IllegalArgumentException -如果 currencyCode不是ISO 4217代码支持。

getInstance

public static Currency getInstance(Locale locale)

返回指定区域的国家 Currency实例。语言和语言的不同组件将被忽略。随着时间的推移，结果可能会有所不同，因为国家改变他们的货币。例如，对于欧洲货币联盟的原始成员国，该方法返回旧的国家货币，直到2001年12月31日，和欧元从2002年1月1日，各自国家的地方时间。

该方法返回null领土，没有货币，如南极洲。

参数

locale -现场为其国家的 Currency实例是必要的

结果

的 Currency实例为国家的特定地点，或 null

异常

NullPointerException -如果 locale或其国家代码是 null

IllegalArgumentException如果给定的 locale国家不支持ISO 3166国家代码。

getAvailableCurrencies

public static Set<Currency> getAvailableCurrencies()

获取可用货币的集合。返回的货币集合包含所有可用的货币，其中可能包括代表过时的国际标准化组织4217码的货币。该集可以在运行时修改，而不影响可用的货币。

结果

可用货币的集合。如果运行时没有可用的货币，则返回的集合是空的。

从以下版本开始：

一点七

getCurrencyCode

public String getCurrencyCode()

获取此货币的国际标准化4217货币代码。

结果

该货币的国际标准化组织4217货币代码。

getSymbol

public String getSymbol()

获取默认 DISPLAY现场这种货币符号。例如，美国的美元符号“$”如果默认的地区是美国，而这可能是“美元”的其他地区。如果没有符号可以被确定，则返回了国际标准组织4217货币代码。

这相当于调用getSymbol(Locale.getDefault(Locale.Category.DISPLAY))。

结果

为默认 DISPLAY现场这种货币符号

getSymbol

public String getSymbol(Locale locale)

获取指定区域的此货币的符号。例如，美国的美元符号“$”如果指定的地点是美国，而这可能是“美元”的其他地区。如果没有符号可以被确定，则返回了国际标准组织4217货币代码。

参数

locale -设置为该货币的显示名称是必要的

结果

此货币的符号为指定的区域设置

异常

NullPointerException -如果 locale是空的

getDefaultFractionDigits

public int getDefaultFractionDigits()

获取此货币使用的小数位数的默认值。例如，欧元的默认数字为2，而日本为0。在伪货币，如国际货币基金组织的特别提款权的情况下，- 1被退回。

结果

此货币使用的小数位数的默认值

getNumericCode

public int getNumericCode()

返回此货币的国际标准化组织4217数字代码。

结果

该货币的国际标准化组织4217数字代码

从以下版本开始：

一点七

getDisplayName

public String getDisplayName()

而得名，适用于默认 DISPLAY现场显示该货币。如果默认区域设置没有找到合适的显示名称，则返回了4217个货币代码。

这相当于调用getDisplayName(Locale.getDefault(Locale.Category.DISPLAY))。

结果

为默认 DISPLAY现场这种货币的显示名称

从以下版本开始：

一点七

getDisplayName

public String getDisplayName(Locale locale)

获取适合于为指定的区域设置显示该货币的名称。如果在指定的区域设置没有找到合适的显示名称，则返回了该等4217货币代码。

参数

locale -设置为该货币的显示名称是必要的

结果

此货币的显示名称为指定的区域设置

异常

NullPointerException -如果 locale是空的

从以下版本开始：

一点七

toString

public String toString()

返回此货币的国际标准化组织4217货币代码。

重写：

toString 方法重写，继承类 Object

结果

该货币的国际标准化组织4217货币代码