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 통화 코드를 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

그 통화의 ISO 4217 통화 코드