鴻蒙OS Currency

Currency

java.lang.Object

|---java.util.Currency

public final class Currency
extends Object
implements Serializable

代表一種貨幣。 貨幣由其 ISO 4217 貨幣代碼標(biāo)識。

該類的設(shè)計使得任何給定貨幣的 Currency 實例都不會超過一個。 因此，沒有公共構(gòu)造函數(shù)。 您可以使用 getInstance 方法獲取 Currency 實例。

用戶可以通過系統(tǒng)屬性 java.util.currency.data 取代 Java 運行時貨幣數(shù)據(jù)。如果定義了此系統(tǒng)屬性，則其值為屬性文件的位置，其內(nèi)容分別是 ISO 3166 國家代碼和 ISO 4217 貨幣數(shù)據(jù)的鍵/值對。價值部分由貨幣的三個 ISO 4217 值組成，即字母代碼、數(shù)字代碼和次要單位。這三個 ISO 4217 值用逗號分隔。以'#' 開頭的行被視為注釋行。如果用戶需要指定一個轉(zhuǎn)換日期來指示新數(shù)據(jù)何時生效，則可以為每個貨幣條目指定一個可選的 UTC 時間戳。時間戳附加到貨幣屬性的末尾，并使用逗號作為分隔符。如果 UTC 日期戳存在且有效，則 JRE 將僅在當(dāng)前 UTC 日期晚于類加載時指定的日期時使用新的貨幣屬性。時間戳的格式必須是 ISO 8601 格式：'yyyy-MM-dd'T'HH:mm:ss'。例如，

示例貨幣屬性 JP=JPZ,999,0

將取代日本的貨幣數(shù)據(jù)。

轉(zhuǎn)換日期JP=JPZ,999,0,2014-01-01T00:00:00 的示例貨幣屬性

如果在 2014 年 1 月 1 日 00:00:00 GMT 之后加載 Currency 類，將取代日本的貨幣數(shù)據(jù)。

如果遇到語法格式錯誤的條目，則忽略該條目并處理文件中的其余條目。 對于存在重復(fù)國家代碼條目的情況，該貨幣的貨幣信息的行為是未定義的，并且文件中的其余條目將被處理。

方法總結(jié)

方法詳情

getInstance

public static Currency getInstance(String currencyCode)

返回給定貨幣代碼的 Currency 實例。

參數(shù)：

返回:

給定貨幣代碼的 Currency 實例

Throws:

getInstance

public static Currency getInstance(Locale locale)

返回給定語言環(huán)境所在國家/地區(qū)的 Currency 實例。 語言環(huán)境的語言和變體組件被忽略。 隨著各國貨幣的變化，結(jié)果可能會隨時間而變化。 例如，對于歐洲貨幣聯(lián)盟的原始成員國，該方法返回截至2001年12月31日的舊國家貨幣，以及從各自國家當(dāng)?shù)貢r間2002年1月1日開始的歐元。

對于沒有貨幣的地區(qū)，例如南極洲，該方法返回 null。

參數(shù)：

返回:

給定語言環(huán)境的國家/地區(qū)的 Currency 實例，或 null

Throws:

getAvailableCurrencies

public static SetCurrency getAvailableCurrencies()

獲取可用貨幣的集合。 返回的貨幣集包含所有可用貨幣，其中可能包括表示過時 ISO 4217 代碼的貨幣。 可以修改該集合而不影響運行時中的可用貨幣。

返回:

可用貨幣的集合。 如果運行時中沒有可用的貨幣，則返回的集合為空。

getCurrencyCode

public String getCurrencyCode()

獲取此貨幣的 ISO 4217 貨幣代碼。

返回:

此貨幣的 ISO 4217 貨幣代碼。

getSymbol

public String getSymbol()

獲取默認(rèn) Locale.Category#DISPLAY 語言環(huán)境的該貨幣的符號。 例如，對于美元，如果默認(rèn)語言環(huán)境是美國，則符號是“$”，而對于其他語言環(huán)境，它可能是“US$”。 如果無法確定符號，則返回 ISO 4217 貨幣代碼。

這相當(dāng)于調(diào)用 getSymbol(Locale.getDefault(Locale.Category.DISPLAY))。

返回:

默認(rèn) Locale.Category#DISPLAY 語言環(huán)境的該貨幣的符號

getSymbol

public String getSymbol(Locale locale)

獲取指定區(qū)域設(shè)置的此貨幣的符號。 例如，對于美元，如果指定的語言環(huán)境是美國，則符號是“$”，而對于其他語言環(huán)境，它可能是“US$”。 如果無法確定符號，則返回 ISO 4217 貨幣代碼。

參數(shù)：

返回:

指定語言環(huán)境的該貨幣符號

Throws:

getDefaultFractionDigits

public int getDefaultFractionDigits()

獲取與此貨幣一起使用的默認(rèn)小數(shù)位數(shù)。 例如，歐元的默認(rèn)小數(shù)位數(shù)為 2，而日元的默認(rèn)位數(shù)為 0。對于偽貨幣（如 IMF 特別提款權(quán)），返回 -1。

返回:

此貨幣使用的默認(rèn)小數(shù)位數(shù)

getNumericCode

public int getNumericCode()

返回此貨幣的 ISO 4217 數(shù)字代碼。

返回:

該貨幣的 ISO 4217 數(shù)字代碼

getDisplayName

public String getDisplayName()

獲取適合在默認(rèn) Locale.Category#DISPLAY 語言環(huán)境中顯示此貨幣的名稱。 如果沒有為默認(rèn)語言環(huán)境找到合適的顯示名稱，則返回 ISO 4217 貨幣代碼。

這相當(dāng)于調(diào)用 getDisplayName(Locale.getDefault(Locale.Category.DISPLAY))。

返回:

默認(rèn) Locale.Category#DISPLAY 語言環(huán)境的此貨幣的顯示名稱

getDisplayName

public String getDisplayName(Locale locale)

獲取適合在指定區(qū)域顯示此貨幣的名稱。 如果沒有為指定區(qū)域找到合適的顯示名稱，則返回 ISO 4217 貨幣代碼。

參數(shù)：

返回:

指定區(qū)域設(shè)置的此貨幣的顯示名稱

Throws:

toString

public String toString()

返回此貨幣的 ISO 4217 貨幣代碼。

覆蓋：

類 Object 中的 toString

返回:

此貨幣的 ISO 4217 貨幣代碼