java.util
클래스 Currency

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

모든 구현 인터페이스:

Serializable

public final class Currency

extends Object

implements Serializable

통화를 나타냅니다. 통화는 ISO 4217 통화 코드로 식별됩니다. 통과 코드의 테이블등의 상세한 것에 대하여는 ISO 4217 관리 기관을 참조해 주세요.

클래스는 지정된 통화의 Currency 인스턴스가 복수 존재하지 않게 설계되고 있습니다. 따라서, 클래스에는 public constructor 이 없습니다. 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 통화 코드를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

그 통화의 ISO 4217 통화 코드