java.util
クラス Currency

java.lang.Object
  |
  +--java.util.Currency

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

Serializable

public final class Currency

extends Object

implements Serializable

通貨を表します。通貨は、ISO 4217 通貨コードで識別されます。 通過コードのテーブルなどの詳細については、ISO 4217 管理機関を参照してください。

クラスは、指定された通貨の Currency インスタンスが複数存在しないように設計されています。したがって、クラスには public コンストラクタがありません。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 インスタンスを返します。ロケールの言語コンポーネントおよびバリアントコンポーネントは無視されます。国によって通貨が変更されるので、時の経過とともに結果が変わる場合があります。たとえば、欧州通貨統合 (EMU) のオリジナルメンバの国々の場合、2001 年 12 月 31 日までは各国の従来の通貨、そして 各国の現地時間の 2002 年 1 月 1 日からは メソッドは Euro を返します。

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

パラメータ:

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

戻り値:

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

例外:

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

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

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()

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

戻り値:

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

toString

public String toString()

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

オーバーライド:

クラス Object 内の toString

戻り値:

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