java.util
Class Currency

java.lang.Object
  java.util.Currency

All Implemented Interfaces:

Serializable

public final class Currency
extends Object
implements Serializable

This class represents a currency as identified in the ISO 4217 currency codes.

See Also:

Serialized Form

Method Summary

String	getCurrencyCode()
int	getDefaultFractionDigits()
static Currency	getInstance(Locale locale) Answers the currency instance for this locale.
static Currency	getInstance(String currencyCode) Answers the currency instance for this curency code.
String	getSymbol()
String	getSymbol(Locale locale) Return the symbol for this currency in the given locale.
String	toString() Answers a string containing a concise, human-readable description of the receiver.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static Currency getInstance(String currencyCode)

Answers the currency instance for this curency code.

Parameters:

currencyCode - java.lang.String

Returns:

currency java.util.Currency

Throws:

IllegalArgumentException - if the currency code is not a supported ISO 4217 currency code

getInstance

public static Currency getInstance(Locale locale)

Answers the currency instance for this locale.

Parameters:

locale - java.util.Locale

Returns:

currency java.util.Currency

Throws:

IllegalArgumentException - if the locale's country is not a supported ISO 3166 Country

getCurrencyCode

public String getCurrencyCode()

getSymbol

public String getSymbol()

getSymbol

public String getSymbol(Locale locale)

Return the symbol for this currency in the given locale.

If the locale doesn't have any countries (e.g. Locale.JAPANESE, new Locale("en","")), currencyCode is returned.

First the locale bundle is checked, if the locale has the same currency, the CurrencySymbol in this locale bundle is returned.

Then a currency bundle for this locale is searched.

If a currency bundle for this locale does not exist, or there is no symbol for this currency in this bundle, than currencyCode is returned.

Parameters:

locale - java.lang.String locale

Returns:

symbol java.lang.String the representation of this Currency's symbol in this locale

getDefaultFractionDigits

public int getDefaultFractionDigits()

toString

public String toString()

Description copied from class: Object

Answers a string containing a concise, human-readable description of the receiver.

Overrides:

toString in class Object

Returns:

String a printable representation for the receiver.