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

另請參見：

序列化表格

方法摘要

String	getCurrencyCode() 獲取此貨幣的 ISO 4217 貨幣程式碼。
int	getDefaultFractionDigits() 獲取與此貨幣一起使用的預設小數位數。
static Currency	getInstance(Locale locale) 返回給定語言環境的國家/地區的 Currency 實例。
static Currency	getInstance(String currencyCode) 返回給定貨幣程式碼的 Currency 實例。
String	getSymbol() 獲取預設語言環境的貨幣符號。
String	getSymbol(Locale locale) 獲取指定語言環境的貨幣符號。
String	toString() 返回此貨幣的 ISO 4217 貨幣程式碼。

從類別 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 為 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 貨幣程式碼