compact1, compact2, compact3

java.util

Валюта класса

java.lang. Объект

java.util. Валюта

Все Реализованные Интерфейсы:

Сериализуемый

public final class Currency
extends Object
implements Serializable

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

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

Пользователи могут заменить данные валюты Среды выполнения Java посредством системного свойства java.util.currency.data. Если это системное свойство определяется тогда, его значение является расположением файла свойств, содержание которого является парами ключ/значение кодов страны ISO 3166 и данных валюты ISO 4217 соответственно. Часть значения состоит из трех значений ISO 4217 валюты, то есть, алфавитный код, числовой код, и незначительный модуль. Те три значения ISO 4217 разделяются запятыми. Строки, которые запускаются с '#, считают строками комментария. Дополнительная метка времени UTC может быть определена на запись валюты, если пользователи должны определить cutover дату, указывающую, когда новые данные входят в силу. Метка времени добавляется до конца свойств валюты и использует запятую в качестве разделителя. Если метка даты UTC будет присутствовать и будет допустима, то JRE будет только использовать новые свойства валюты, если текущая дата UTC будет позже чем дата, определенная во время загрузки class. Формат метки времени должен иметь формат 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 class загружается после 1-ого января 2014 GMT 0:00:00.

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

С тех пор:

1.4

См. Также:

Сериализированная Форма

Сводка метода

Модификатор и Тип	Метод и Описание
static Set<Currency>	getAvailableCurrencies() Получает набор доступных валют.
Строка	getCurrencyCode() Получает код валюты ISO 4217 этой валюты.
int	getDefaultFractionDigits() Получает число значения по умолчанию дробных цифр, используемых с этой валютой.
Строка	getDisplayName() Завоевывает репутацию, который является подходящим для того, чтобы вывести на экран эту валюту для значения по умолчанию DISPLAY локаль.
Строка	getDisplayName(Locale locale) Завоевывает репутацию, который является подходящим для того, чтобы вывести на экран эту валюту для указанной локали.
static Currency	getInstance(Locale locale) Возвраты Currency экземпляр для страны данной локали.
static Currency	getInstance(String currencyCode) Возвраты Currency экземпляр для данного кода валюты.
int	getNumericCode() Возвращает ISO 4217 числовой код этой валюты.
Строка	getSymbol() Получает символ этой валюты для значения по умолчанию DISPLAY локаль.
Строка	getSymbol(Locale locale) Получает символ этой валюты для указанной локали.
Строка	toString() Возвращает код валюты ISO 4217 этой валюты.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь метода

getInstance

public static Currency getInstance(String currencyCode)

Возвраты Currency экземпляр для данного кода валюты.

Параметры:

currencyCode - код ISO 4217 валюты

Возвраты:

Currency экземпляр для данного кода валюты

Броски:

NullPointerException - если currencyCode нуль

IllegalArgumentException - если currencyCode не поддерживаемый код ISO 4217.

getInstance

public static Currency getInstance(Locale locale)

Возвраты Currency экземпляр для страны данной локали. Язык и различные компоненты локали игнорируются. Результат может измениться в течение долгого времени, поскольку страны изменяют свои валюты. Например, для исходных государств-членов европейского Валютного союза, метод возвращает старые валюты разных стран до 31 декабря 2001, и Евро с 1 января 2002, местное время соответствующих стран.

Возвраты метода null для территорий, у которых нет валюты, такой как Антарктида.

Параметры:

locale - локаль та, для чей страны a 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$". Если никакой символ не может быть определен, код валюты ISO 4217 возвращается.

Это эквивалентно вызову getSymbol(Locale.getDefault(Locale.Category.DISPLAY)).

Возвраты:

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

getSymbol

public String getSymbol(Locale locale)

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

Параметры:

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

Возвраты:

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

Броски:

NullPointerException - если locale нуль

getDefaultFractionDigits

public int getDefaultFractionDigits()

Получает число значения по умолчанию дробных цифр, используемых с этой валютой. Например, число значения по умолчанию дробных цифр за Евро 2, в то время как за Японскую иену это 0. В случае псевдовалют, таких как Международный валютный фонд Специальные Права Рисунка,-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 нуль

С тех пор:

1.7

toString

public String toString()

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

Переопределения:

toString в class Object

Возвраты:

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