Currency (Java Platform SE 8)

java.lang.Object
- java.util.Currency

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

Serializable
```
public final class Currency
extends Object
implements Serializable
```
通貨を表します。通貨は、ISO 4217通貨コードで識別されます。詳細は、ISOのWebサイトを参照してください。
クラスは、指定された通貨のCurrencyインスタンスが複数存在しないように設計されています。したがって、クラスにはpublicコンストラクタがありません。getInstanceメソッドを使用して、Currencyインスタンスを取得します。
ユーザーはjava.util.currency.dataシステム・プロパティを使って、Javaランタイム通貨データを置き換えることができます。このシステム・プロパティが定義されている場合、その値はプロパティ・ファイルの場所であり、そのファイル内容はISO 3166国コードとISO 4217通貨データからなるキーと値のペアです。値の部分はISO 4217の3つの通貨の値、つまり、英字コード、数値コード、マイナー単位で構成されます。これら3つのISO 4217の値はカンマで区切られています。「#」で始まる行はコメント行としてみなされます。ユーザーが切換え日を指定して新しいデータが有効になる時期を示す必要がある場合は、通貨エントリごとにオプションのUTCタイムスタンプを指定できます。そのタイムスタンプは通貨プロパティの最後に追加され、区切り文字としてコンマを使用します。UTC日付スタンプが存在し、有効である場合、JREでは、現在のUTC日付が、クラスのロード時に指定された日付よりも後にあるときにのみ、新しい通貨プロパティを使用します。タイムスタンプのフォーマットは、ISO 8601形式の'yyyy-MM-dd'T'HH:mm:ss'である必要があります。次に例を示します。
#Sample currency properties JP=JPZ,999,0
日本の通貨データがこれに置き換わります。
#Sample currency properties with cutover date JP=JPZ,999,0,2014-01-01T00:00:00
Currencyクラスが2014年1月1日00:00:00 GMTより後にロードされる場合は、日本の通貨データがこれに置き換わります。
構文的に不正な形式のエントリが検出された場合、そのエントリは無視され、ファイル内の残りのエントリは処理されます。たとえば、国コード・エントリが重複して存在する場合、そのCurrencyの通貨情報の動作は未定義であり、ファイル内の残りのエントリが処理されます。

導入されたバージョン:

1.4

関連項目:

直列化された形式

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`static Set<Currency>`	`getAvailableCurrencies()` 利用可能な通貨のセットを取得します。
`String`	`getCurrencyCode()` この通貨のISO 4217通貨コードを取得します。
`int`	`getDefaultFractionDigits()` この通貨で使用される小数のデフォルトの桁数を取得します。
`String`	`getDisplayName()` デフォルトの`DISPLAY`ロケールでこの通貨を表示するのに適した名前を取得します。
`String`	`getDisplayName(Locale locale)` 指定されたロケールでこの通貨を表示するのに適した名前を取得します。
`static Currency`	`getInstance(Locale locale)` 指定されたロケールの国の`Currency`インスタンスを返します。
`static Currency`	`getInstance(String currencyCode)` 指定された通貨コードの`Currency`インスタンスを返します。
`int`	`getNumericCode()` この通貨のISO 4217数値コードを返します。
`String`	`getSymbol()` デフォルトの`DISPLAY`ロケールについて、その通貨の記号を取得します。
`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インスタンスを返します。ロケールの言語コンポーネントおよびバリアント・コンポーネントは無視されます。国によって通貨が変更されるので、時の経過とともに結果が変わる場合があります。たとえば、欧州通貨統合のオリジナル・メンバーの国々の場合、2001年12月31日までは各国の従来の通貨、そして各国の現地時間の2002年1月1日からはメソッドはEuroを返します。
    メソッドは、南極大陸などの通貨を持たない地域についてはnullを返します。
    
    パラメータ:
    
    locale - Currencyインスタンスが必要な国のロケール
    
    戻り値:
    
    指定されたロケールの国のCurrencyインスタンス、またはnull
    
    例外:
    
    NullPointerException - localeまたはその国コードがnullの場合
    
    IllegalArgumentException - 指定されたlocaleの国がサポートされたISO 3166国コードでない場合。
  - getAvailableCurrencies
```
public static Set<Currency> getAvailableCurrencies()
```
    利用可能な通貨のセットを取得します。返される通貨のセットには、利用可能なすべての通貨が含まれ、廃止されたISO 4217コードに相当する通貨が含まれることもあります。このセットは、実行時に利用可能な通貨に影響を及ぼさないように変更できます。
    
    戻り値:
    
    利用可能な通貨のセット。実行時に利用可能な通貨が存在しない場合、空のセットが返されます。
    
    導入されたバージョン:
    
    1.7
  - getCurrencyCode
```
public String getCurrencyCode()
```
    この通貨のISO 4217通貨コードを取得します。
    
    戻り値:
    
    この通貨のISO 4217通貨コード。
  - getSymbol
```
public String getSymbol()
```
    デフォルトのDISPLAYロケールについて、その通貨の記号を取得します。たとえば、USドルについては、デフォルトのロケールがUSの場合は、記号は「$」になります。ほかのロケールの場合は、記号は「US$」になります。記号を判断できない場合は、ISO 4217通貨コードを返します。
    これは、getSymbol(Locale.getDefault(Locale.Category.DISPLAY))を呼び出すことと同等です。
    
    戻り値:
    
    デフォルトのDISPLAYロケールでのこの通貨の記号
  - getSymbol
```
public String getSymbol(Locale locale)
```
    指定されたロケールでのこの通貨の記号を取得します。たとえば、USドルについては、指定されたロケールがUSの場合は、記号は「$」になります。ほかのロケールの場合は、記号は「US$」になります。記号を判断できない場合は、ISO 4217通貨コードを返します。
    
    パラメータ:
    
    locale - この通貨の表示名が必要なロケール
    
    戻り値:
    
    指定されたロケールでのこの通貨の記号
    
    例外:
    
    NullPointerException - localeがnullである場合
  - getDefaultFractionDigits
```
public int getDefaultFractionDigits()
```
    この通貨で使用される小数のデフォルトの桁数を取得します。たとえば、ユーロの場合は小数のデフォルトの桁数は2で、日本円の場合は0です。IMFの特別引出権のような、擬似通貨の場合は、-1を返します。
    
    戻り値:
    
    この通貨で使用される小数のデフォルトの桁数
  - getNumericCode
```
public int getNumericCode()
```
    この通貨のISO 4217数値コードを返します。
    
    戻り値:
    
    その通貨のISO 4217数値コード
    
    導入されたバージョン:
    
    1.7
  - getDisplayName
```
public String getDisplayName()
```
    デフォルトのDISPLAYロケールでこの通貨を表示するのに適した名前を取得します。デフォルトのロケールで適した表示名が見つからない場合、ISO 4217通貨コードが返されます。
    これは、getDisplayName(Locale.getDefault(Locale.Category.DISPLAY))を呼び出すことと同等です。
    
    戻り値:
    
    デフォルトのDISPLAYロケールでのこの通貨の表示名
    
    導入されたバージョン:
    
    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通貨コード

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスCurrency

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

メソッドの詳細

getInstance

getInstance

getAvailableCurrencies

getCurrencyCode

getSymbol

getSymbol

getDefaultFractionDigits

getNumericCode

getDisplayName

getDisplayName

toString