java.util

クラス Currency

java.lang.Object

java.util.Currency

すべての実装されたインタフェース:

Serializable

public final class Currency
extends Object
implements Serializable

通貨を表します。通貨は、ISO 4217 通貨コードで識別されます。詳細は、ISO の Web サイトを参照してください。このサイトで、通貨コード表を確認できます。

クラスは、指定された通貨の Currency インスタンスが複数存在しないように設計されています。したがって、クラスには public コンストラクタがありません。getInstance メソッドを使用して、Currency インスタンスを取得します。

ユーザーは <JAVA_HOME>/lib/currency.properties という名前のプロパティーファイルを作成することによって、Java ランタイム通貨データを置き換えることができます。プロパティーファイルの内容は、ISO 3166 国番号と ISO 4217 通貨データからなるキーと値のペアです。値の部分は ISO 4217 の 3 つの通貨の値、つまり、英字コード、数値コード、マイナー単位で構成されます。これら 3 つの ISO 4217 の値はコンマで区切られています。「#」で始まる行はコメント行としてみなされます。次に例を示します。

#Sample currency properties
JP=JPZ,999,0

これは日本の通貨データに置き換わります。

導入されたバージョン:

1.4

関連項目:

直列化された形式

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
static Set<Currency>	getAvailableCurrencies() 利用可能な通貨のセットを取得します。
String	getCurrencyCode() この通貨の ISO 4217 通貨コードを取得します。
int	getDefaultFractionDigits() この通貨とともに使用される小数点のデフォルトの桁数を取得します。
String	getDisplayName() デフォルトのロケールでこの通貨を表示するのに適した名前を取得します。
String	getDisplayName(Locale locale) 指定されたロケールでこの通貨を表示するのに適した名前を取得します。
static Currency	getInstance(Locale locale) 指定されたロケールの国の Currency インスタンスを返します。
static Currency	getInstance(String currencyCode) 指定された通貨コードの Currency インスタンスを返します。
int	getNumericCode() この通貨の ISO 4217 数値コードを返します。
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 インスタンスを返します。ロケールの言語コンポーネントおよびバリアントコンポーネントは無視されます。国によって通貨が変更されるので、時の経過とともに結果が変わる場合があります。たとえば、欧州通貨統合 (EMU) のオリジナルメンバーの国々の場合、2001 年 12 月 31 日までは各国の従来の通貨、そして各国の現地時間の 2002 年 1 月 1 日からは メソッドは Euro を返します。

メソッドは、南極大陸などの通貨を持たない地域については null を返します。

パラメータ:

locale - Currency インスタンスが必要な国のロケール

戻り値:

指定したロケールの国の Currency インスタンス、または null

例外:

NullPointerException - locale またはその国コードが null の場合

IllegalArgumentException - 指定されたロケールの国がサポートされた ISO 3166 国コードでない場合。

getAvailableCurrencies

public static Set<Currency> getAvailableCurrencies()

利用可能な通貨のセットを取得します。返される通貨のセットには、利用可能なすべての通貨が含まれ、廃止された ISO 4217 コードに相当する通貨が含まれることもあります。このセットは、実行時に利用可能な通貨に影響を及ぼさないように変更できます。

戻り値:

利用可能な通貨のセット。実行時に利用可能な通貨が存在しない場合、空のセットが返されます。

導入されたバージョン:

1.7

getCurrencyCode

public String getCurrencyCode()

この通貨の ISO 4217 通貨コードを取得します。

戻り値:

この通貨の ISO 4217 通貨コード。

getSymbol

public String getSymbol()

デフォルトロケールについて、その通貨の記号を取得します。たとえば、US ドルについては、デフォルトのロケールが US の場合は、記号は「$」になります。ほかのロケールの場合は、記号は「US$」になります。記号を判断できない場合は、ISO 4217 通貨コードを返します。

戻り値:

デフォルトロケールの現地通貨の記号

getSymbol

public String getSymbol(Locale locale)

指定されたロケールについて、その通貨の記号を取得します。たとえば、US ドルについては、指定されたロケールが US の場合は、記号は「$」になります。ほかのロケールの場合は、記号は「US$」になります。記号を判断できない場合は、ISO 4217 通貨コードを返します。

パラメータ:

locale - この通貨の表示名が必要なロケール

戻り値:

指定されたロケールの現地通貨の記号

例外:

NullPointerException - locale が null である場合

getDefaultFractionDigits

public int getDefaultFractionDigits()

この通貨とともに使用される小数点のデフォルトの桁数を取得します。日本の円の場合は、0 です。IMF の特別引出権のような、擬似通貨の場合は、-1 を返します。

戻り値:

この通貨とともに使用される小数点のデフォルトの桁数

getNumericCode

public int getNumericCode()

この通貨の ISO 4217 数値コードを返します。

戻り値:

その通貨の ISO 4217 数値コード

導入されたバージョン:

1.7

getDisplayName

public String getDisplayName()

デフォルトのロケールでこの通貨を表示するのに適した名前を取得します。デフォルトのロケールで適した表示名が見つからない場合、ISO 4217 通貨コードが返されます。

戻り値:

デフォルトのロケールでのこの通貨の表示名

導入されたバージョン:

1.7

getDisplayName

public String getDisplayName(Locale locale)

指定されたロケールでこの通貨を表示するのに適した名前を取得します。指定されたロケールで適した表示名が見つからない場合、ISO 4217 通貨コードが返されます。

パラメータ:

locale - この通貨の表示名が必要なロケール

戻り値:

指定されたロケールでのこの通貨の表示名

例外:

NullPointerException - locale が null である場合

導入されたバージョン:

1.7

toString

public String toString()

その通貨の ISO 4217 通貨コードを返します。

オーバーライド:

toString、クラス: Object

戻り値:

その通貨の ISO 4217 通貨コード