Класс Currency

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

Пользователи могут заменить данные о валюте Java runtime с помощью системной переменной 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

заменит данные о валюте Японии. Если JPZ является одним из существующих кодов валюты ISO 4217, используемых другими странами, существующие данные валюты JPZ обновляются с заданными числовым кодом и значением наименьшей единицы.

#Sample currency properties with cutover date
JP=JPZ,999,0,2014-01-01T00:00:00

заменит данные о валюте Японии, если класс Currency загружается после 1 января 2014 года 00:00:00 по Гринвичу.

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

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

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