java.util
类 Currency

java.lang.Object
  java.util.Currency

所有已实现的接口：

Serializable

public final class Currency
     

      extends 
      Object
     
     

      implements 
      Serializable
     

表示货币。货币由 ISO 4217 货币代码标识。有关此内容的详细消息（包括货币代码表），请访问 BSi 网站 。

该类的设计目标是：对于任何指定货币，从不会有多个 Currency 实例。因此，没有公共的构造方法。可以使用 getInstance 方法获得 Currency 实例。

从以下版本开始：

1.4

另请参见：

序列化表格

getInstance

public static Currency getInstance(String currencyCode)

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

参数：

currencyCode - 货币的 ISO 4217 代码

返回：

给定货币代码的 Currency 实例

抛出：

NullPointerException - 如果 currencyCode 为 null

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 - 如果给定语言环境的国家/地区不是受支持的 ISO 3166 国家/地区代码。

getCurrencyCode

public String getCurrencyCode()

获取此货币的 ISO 4217 货币代码。

返回：

此货币的 ISO 4217 货币代码。

getSymbol

public String getSymbol()

获取默认语言环境的货币符号。例如，对于美元，如果默认语言环境是美国，则符号是 "$"，而对于其他语言环境，它可能是 "US$"。如果无法确定符号，则返回 ISO 4217 货币代码。

返回：

默认语言环境的货币符号

getSymbol

public String getSymbol(Locale locale)

获取指定语言环境的货币符号。例如，对于美元，如果指定语言环境是美国，则符号是 "$"，而对于其他语言环境，它可能是 "US$"。如果无法确定符号，则返回 ISO 4217 货币代码。

参数：

locale - 需要显示此货币名称的语言环境

返回：

指定语言环境的货币符号

抛出：

NullPointerException - 如果 locale 为 null

getDefaultFractionDigits

public int getDefaultFractionDigits()

获取与此货币一起使用的默认小数位数。例如对于欧元，默认的小数位数为 2，而对于日元，则为 0。对于伪货币（如 IMF Special Drawing Rights），则返回 -1。

返回：

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

toString

public String toString()

返回此货币的 ISO 4217 货币代码。

覆盖：

类 Object 中的 toString

返回：

此货币的 ISO 4217 货币代码