java.util
클래스 Currency

java.lang.Object 
  java.util.Currency

모든 구현된 인터페이스:

Serializable

public final class Currency
extends Object 
implements Serializable 

통화를 나타냅니다. 통화는, ISO 4217 통화 코드로 식별됩니다. 자세한 것은,BSi 의 Web 사이트를 참조해 주세요. 이 사이트에서, 통화 코드표를 확인할 수 있습니다.

클래스는, 지정된 통화의 Currency 인스턴스가 복수 존재하지 않게 설계되고 있습니다. 따라서, 클래스에는 public 생성자 이 없습니다. getInstance 메소드를 사용해,Currency 인스턴스를 가져옵니다.

도입된 버젼:

1.4

관련 항목:

직렬화 된 형식

메소드의 개요

String	getCurrencyCode () 이 통화의 ISO 4217 통화 코드를 가져옵니다.
int	getDefaultFractionDigits () 예를 들어, Euro 의 소수점의 디폴트의 자리수는 2 입니다.
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 통화 코드