Класс Currency

public final class Currency
extends Object
implements Serializable

Представляет валюту. Валюты идентифицируются по их кодам ISO 4217. Посетите веб-сайт ISO для получения дополнительной информации.

Класс разработан таким образом, что для любой заданной валюты существует не более одного Currency экземпляра. Поэтому публичный конструктор отсутствует. Вы получаете экземпляр Currency с помощью методов getInstance.

Пользователи могут заменить данные о валюте Java-среды с помощью системной переменной java.util.currency.data. Если эта системная переменная определена, то ее значение — это местоположение файла свойств, содержимое которого — пары ключ/значение кодов стран ISO 3166 и данных о валютах ISO 4217 соответственно. Значение части состоит из трех значений ISO 4217 для валюты, то есть буквенного кода, числового кода и младшей единицы. Эти три значения 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 загружен после 1 января 2014 года 00:00:00 по Гринвичу.

В случае столкновения с синтаксически некорректными записями запись игнорируется, и обработка оставшихся записей в файле продолжается. В случаях существования дублирующихся записей кода страны поведение информации о валюте для этой Currency является неопределенным, и обработка оставшихся записей в файле продолжается.

Методы

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)

Параметры:

locale - локальная область, для страны которой требуется Currency экземпляр

Возвращает:

экземпляр Currency для страны заданной локальной области или null

Исключения:

NullPointerException - если locale или ее код страны null

IllegalArgumentException - если страна заданной locale не является поддерживаемым кодом страны ISO 3166.

getAvailableCurrencies

public static Set<Currency> getAvailableCurrencies()

Возвращает набор доступных валют. Возвращаемый набор валют содержит все доступные валюты, включая валюты, представляющие устаревшие коды ISO 4217. Набор может быть изменен без влияния на доступные валюты в среде выполнения.

Возвращает:

набор доступных валют. Если в среде выполнения нет доступных валют, возвращаемый набор пустой.

C момента:

1.7

getCurrencyCode

public String getCurrencyCode()

Возвращает код валюты ISO 4217 для этой валюты.

Возвращает:

код валюты ISO 4217 для этой валюты.

getSymbol

public String getSymbol()

Возвращает:

символ этой валюты для локальной области по умолчанию DISPLAY

getSymbol

public String getSymbol(Locale locale)

Возвращает символ этой валюты для заданной локальной области. Например, для американского доллара символ — "$" при заданной локальной области США, в то время как для других локальных областей это может быть "US$". Если символ определить нельзя, возвращается код валюты ISO 4217.

Параметры:

locale - локальная область, для которой требуется имя отображения этой валюты

Возвращает:

символ этой валюты для заданной локальной области

Исключения:

NullPointerException - если locale равно null

getDefaultFractionDigits

public int getDefaultFractionDigits()

Возвращает стандартное количество знаков после запятой, используемых для этой валюты. Например, стандартное количество знаков после запятой для евро — 2, а для японской иены — 0. В случае псевдо-валют, таких как МВФ СДР, возвращается -1.

Возвращает:

стандартное количество знаков после запятой, используемых для этой валюты

getNumericCode

public int getNumericCode()

Возвращает числовой код ISO 4217 для этой валюты.

Возвращает:

числовой код ISO 4217 для этой валюты

C момента:

1.7

getDisplayName

public String getDisplayName()

Возвращает:

имя отображения этой валюты для локальной области по умолчанию DISPLAY

C момента:

1.7

getDisplayName

public String getDisplayName(Locale locale)

Возвращает имя, подходящее для отображения этой валюты для заданной локальной области. Если подходящее имя отображения не найдено для заданной локальной области, возвращается код валюты ISO 4217.

Параметры:

locale - локальная область, для которой требуется имя отображения этой валюты

Возвращает:

имя отображения этой валюты для заданной локальной области

Исключения:

NullPointerException - если locale равно null

C момента:

1.7

toString

public String toString()

Возвращает код валюты ISO 4217 для этой валюты.

Переопределяет:

toString в классе Object

Возвращает:

код валюты ISO 4217 для этой валюты