Skip to content

Most visited

Recently visited

navigation
Added in API level 1

Currency

public final class Currency
extends Object implements Serializable

java.lang.Object
   ↳ java.util.Currency


A currency corresponding to an ISO 4217 currency code such as "EUR" or "USD".

Summary

Public methods

static Set<Currency> getAvailableCurrencies()

Returns a set of all known currencies.

String getCurrencyCode()

Returns this currency's ISO 4217 currency code.

int getDefaultFractionDigits()

Returns the default number of fraction digits for this currency.

String getDisplayName(Locale locale)

Returns the localized name of this currency in the given locale.

String getDisplayName()

Equivalent to getDisplayName(Locale.getDefault()).

static Currency getInstance(Locale locale)

Returns the Currency instance for this Locale's country.

static Currency getInstance(String currencyCode)

Returns the Currency instance for the given ISO 4217 currency code.

String getSymbol(Locale locale)

Returns the localized currency symbol for this currency in locale.

String getSymbol()

Equivalent to getSymbol(Locale.getDefault()).

String toString()

Returns this currency's ISO 4217 currency code.

Inherited methods

From class java.lang.Object

Public methods

getAvailableCurrencies

Added in API level 19
Set<Currency> getAvailableCurrencies ()

Returns a set of all known currencies.

Returns
Set<Currency>

getCurrencyCode

Added in API level 1
String getCurrencyCode ()

Returns this currency's ISO 4217 currency code.

Returns
String

getDefaultFractionDigits

Added in API level 1
int getDefaultFractionDigits ()

Returns the default number of fraction digits for this currency. For instance, the default number of fraction digits for the US dollar is 2 because there are 100 US cents in a US dollar. For the Japanese Yen, the number is 0 because coins smaller than 1 Yen became invalid in 1953. In the case of pseudo-currencies, such as IMF Special Drawing Rights, -1 is returned.

Returns
int

getDisplayName

Added in API level 19
String getDisplayName (Locale locale)

Returns the localized name of this currency in the given locale. Returns the ISO 4217 currency code if no localized name is available.

Parameters
locale Locale
Returns
String

getDisplayName

Added in API level 19
String getDisplayName ()

Equivalent to getDisplayName(Locale.getDefault()). See "Be wary of the default locale".

Returns
String

getInstance

Added in API level 1
Currency getInstance (Locale locale)

Returns the Currency instance for this Locale's country.

Parameters
locale Locale
Returns
Currency
Throws
IllegalArgumentException if the locale's country is not a supported ISO 3166 country.

getInstance

Added in API level 1
Currency getInstance (String currencyCode)

Returns the Currency instance for the given ISO 4217 currency code.

Parameters
currencyCode String
Returns
Currency
Throws
IllegalArgumentException if the currency code is not a supported ISO 4217 currency code.

getSymbol

Added in API level 1
String getSymbol (Locale locale)

Returns the localized currency symbol for this currency in locale. That is, given "USD" and Locale.US, you'd get "$", but given "USD" and a non-US locale, you'd get "US$".

If the locale only specifies a language rather than a language and a country (such as Locale.JAPANESE or {new Locale("en", "")} rather than Locale.JAPAN or {new Locale("en", "US")}), the ISO 4217 currency code is returned.

If there is no locale-specific currency symbol, the ISO 4217 currency code is returned.

Parameters
locale Locale
Returns
String

getSymbol

Added in API level 1
String getSymbol ()

Equivalent to getSymbol(Locale.getDefault()). See "Be wary of the default locale".

Returns
String

toString

Added in API level 1
String toString ()

Returns this currency's ISO 4217 currency code.

Returns
String a printable representation of this object.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.