JavaTM 2 Platform
Standard Ed. 5.0

java.util
クラス Currency

java.lang.Object
  上位を拡張 java.util.Currency
すべての実装されたインタフェース:
Serializable

public final class Currency
extends Object
implements Serializable

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

クラスは、指定された通貨の 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 通貨コード

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。