Шаблон:Валютный курс
Документация
 |
Отказ от ответственности. Данные, которые транслируются описываемыми шаблонами, могут отличаться от официальных курсов, установленных центральными банками, а также от рыночных курсов, транслируемых через другие информационные каналы. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.
|
Настоящая документация описывает совместную работу нескольких шаблонов.
Основной шаблон — {{Валютный курс}}, отвечающий за вывод данных в конечных статьях и списках (см. раздел «Примеры использования»).
Автоматически обновляемые шаблоны:
- {{Валютный курс/Данные}} — шаблон, где собираются текущие котировки из открытых источников, которые затем использует шаблон {{Валютный курс}};
- {{Валютный курс/Данные МВФ}} — шаблон, который отвечает за сбор данных по валютам, котируемым Международным валютным фондом, и транслирует их в шаблон {{Валютный курс/Данные}};
- {{Валютный курс/Данные ЕЦБ}} — шаблон, который отвечает за сбор данных по валютам, котируемым Европейским центральным банком, и транслирует их в шаблон {{Валютный курс/Данные}};
- {{Валютный курс/Данные ЦБ РФ}} — шаблон, который отвечает за сбор данных по валютам, котируемым Центральным банком Российской Федерации, и транслирует их в шаблон {{Валютный курс/Данные}}.
Вручную обновляемые шаблоны:
- {{Валютный курс/Фиксированные курсы}} — вспомогательный шаблон, где собираются данные о фиксированных курсах, используемых затем в шаблоне {{Валютный курс/Данные}};
- {{Валютный курс/Имена валют на сайте МВФ}} — вспомогательный шаблон, необходимый для работы шаблона {{Валютный курс/Данные МВФ}}.
Все вместе они позволяют отображать в статьях, списках и других шаблонах текущий (автоматически обновляемый не реже одного раза в сутки) валютный курс практически по всем существующим валютам, имеющим код ISO 4217.
Примеры использования
- Примеры простого использования
Для вывода курса нужно знать коды ISO 4217 той валютной пары, чье соотношение необходимо вывести.
| Шаблон | Результат | Примечания |
|---|---|---|
| {{Валютный курс|RUB|USD}} | 62,9 | 1 USD = 62,9 RUB |
| {{Валютный курс|USD|RUB}} | 0,0159 | 1 RUB = 0,0159 USD |
| {{Валютный курс|RUB|EUR}} | 68,7 | 1 EUR = 68,7 RUB |
| {{Валютный курс|EUR|RUB}} | 0,01456 | 1 RUB = 0,01456 EUR |
| {{Валютный курс|RUB|GBP}} | 76,33 | 1 GBP = 76,33 RUB |
| {{Валютный курс|GBP|RUB}} | 0,0131 | 1 RUB = 0,0131 GBP |
| {{Валютный курс|USD|EUR}} | 1,092 | 1 EUR = 1,092 USD |
| {{Валютный курс|EUR|USD}} | 0,9156 | 1 USD = 0,9156 EUR |
- Примеры использования с множителем и параметром «дата»
Шаблон позволяет выводить дату, которой соответствуют данные, а также использовать множитель для сокращения числа нулей.
| Шаблон | Результат | Примечания |
|---|---|---|
| {{Валютный курс|GBP|RUB}} | 0,0131 | 1 RUB = 0,0131 GBP |
| {{Валютный курс|GBP|RUB|1}} | 0,0131 | 1 RUB = 0,0131 GBP |
| {{Валютный курс|GBP|RUB|10}} | 0,131 | 10 RUB = 0,131 GBP |
| {{Валютный курс|GBP|RUB|100}} | 1,31 | 100 RUB = 1,31 GBP |
| {{Валютный курс|RUB|Дата}} | 28 октября 2016 | Дата, которой соответствуют данные |
- Примеры, когда код валюты неизвестен шаблонам или данные о ней в шаблонах отсутствуют
Если валюта неизвестна шаблону (сведения о ней отсутствуют в шаблонах {{Валютный курс/Данные}} и {{Валютный курс/Фиксированные курсы}}), то результат будет пустым.
| Шаблон | Результат | Примечания |
|---|---|---|
| {{Валютный курс|КОД|EUR}} | Результат пустой | |
| {{Валютный курс|EUR|КОД}} | Результат пустой | |
| {{Валютный курс|XXX|EUR}} | Результат пустой | |
| {{Валютный курс|EUR|XXX}} | Результат пустой | |
| {{Валютный курс|КОД|Дата}} | Дата для неизвестной валюты также будет пустой | |
| {{Валютный курс|XXX|Дата}} | Дата для неизвестной валюты также будет пустой |
- См. также примеры использования в таких статьях, списках и шаблонах, как
Техническая реализация
Порядок взаимодействия шаблонов
Курсы валютных пар рассчитываются автоматически на основе данных, собираемых и обновляемых роботом KrBot из трёх источников (см. раздел «Источники данных»):
- котировки Международного валютного фонда;
- котировки Европейского центрального банка;
- котировки Центрального банка Российской Федерации.
Ручное изменение данных не требуется и не рекомендуется.
Курсы для валют, имеющих жёсткую привязку к другим валютам, автоматически вычисляются как кросс-курсы на основе вручную прописанных статических данных шаблона {{Валютный курс/Фиксированные курсы}} и динамических данных из шаблона {{Валютный курс/Данные}}. В случае изменения курсового режима или значения фиксированного курса, необходимо внести соответствующие изменения в шаблон {{Валютный курс/Фиксированные курсы}}.
Параметры выводимых курсов и отказ от ответственности
Выводимые настоящими шаблонами курсы основаны на открытых источниках и транслируются с округлением до четырёх значимых цифр. Они могут отличаться от официальных котировок, установленных центральными банками, они могут отличаться от курсов, транслируемых другими источниками информации. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.
Вопросы и предложения
В разработке шаблонов принимали участие несколько человек, поэтому для вопросов и предложений рекомендуется использовать страницу обсуждения шаблона «Валютный курс».
Не рекомендуется поднимать вопросы, обсуждавшиеся на страницах «Форум/Вниманию участников#Шаблон Валюта» и «Обсуждение шаблона:Валютный курс», без достаточных на то оснований и появления новых весомых аргументов, которые не были рассмотрены участниками.
Источники данных
 |
Внимание! Вы поможете проекту, если предложите источники данных лучше существующих! |
Шаблон «Валютный курс/Данные»
Источниками данных для работы шаблонов, отвечающих за вывод валютных курсов являются:
- Международный валютный фонд — [www.imf.org/external/np/fin/data/rms_five.aspx];
- Европейский центральный банк — [www.ecb.int/stats/eurofxref/eurofxref-daily.xml];
- Центральный банк Российской Федерации — [www.cbr.ru/scripts/XML_daily.asp].
К сожалению, используемые источники на дают полного набора валютных пар. Мы будем благодарны, если вы предложите источник с лучшими характеристиками.
Требования к источнику информации следующие — он должен:
- Предоставлять информацию об актуальных курсах по соизмеримому (не менее 100 валют) или большему числу валют с частотой обновления не реже одного раза в неделю.
- Предоставлять данные по лицензиям, используемым в Википедии ([creativecommons.org/licenses/by-sa/3.0/deed.ru Creative Commons Attribution/Share-Alike 3.0] и [www.gnu.org/copyleft/fdl.html GFDL]).
- В полной мере соответствовать требованиям, предъявляемым к источникам, которые принято использовать для подготовки статей «Википедии».
- Предоставлять удобный интерфейс для автоматического забора данных.
Шаблон «Валютный курс/Фиксированные курсы»
Данные шаблона {{Валютный курс/Фиксированные курсы}} (фиксированные курсы, а также курсы с очень узким коридором) приведены со ссылкой на сайты эмитентов или другие языковые разделы «Википедии», прежде всего английский. Данные источники не вполне удобны для автоматического отслеживания, поэтому мы будем признательны, если вы предложите более удачный источник.
Текущие фиксированные курсы
| Валюта | Код ISO 4217 | Значение фиксированного курса | Источник | ||
|---|---|---|---|---|---|
| По отношению к доллару США (USD) | |||||
| Панамский бальбоа | PAB | 1 USD = 1 PAB | en:Panamanian balboa | ||
| Сальвадорский колон | SVC | 1 USD = 8,75 SVC | [www.bcr.gob.sv/?cat=1068&title=US%20Dollars&lang=en Сайт эмитента] | ||
| Восточно-карибский доллар | XCD | 1 USD = 2,7 XCD | [www.eccb-centralbank.org/Currency/exchange.asp#exchangerates Сайт эмитента] | ||
| Гонконгский доллар | HKD | 1 USD = 7,8 HKD | [www.hkma.gov.hk/eng/key-functions/monetary-stability.shtml Сайт эмитента] | ||
| Франк Джибути | DJF | 1 USD = 177,7 DJF | [www.banque-centrale.dj/francs/board Сайт эмитента] | ||
| Арубанский флорин | AWG | 1 USD = 1,79 AWG | en:Aruban florin | ||
| Багамский доллар | BSD | 1 USD = 1 BSD | [www.centralbankbahamas.com/exchange.php Сайт эмитента] | ||
| Бахрейнский динар | BHD | 1 USD = 0,376 BHD | [www.cbb.gov.bh/page-p-exchange_rate_policy.htm Сайт эмитента] | ||
| Барбадосский доллар | BBD | 1 USD = 2 BBD | [www.centralbank.org.bb/WEBCBB.nsf/webpage/48ABCC1607F95BCE042576820056F4E0 Сайт эмитента] | ||
| Белизский доллар | BZD | 1 USD = 2 BZD | [www.centralbank.org.bz/currency Сайт эмитента] | ||
| Эритрейская накфа | ERN | 1 USD = 15 ERN | en:Eritrean nakfa | ||
| Доллар Тринидада и Тобаго | TTD | 1 USD = 6,251 TTD | en:Trinidad and Tobago dollar | ||
| Дирхам ОАЭ | AED | 1 USD = 3,673 AED | en:United Arab Emirates dirham | ||
| Иорданский динар | JOD | 1 USD = 0,709 JOD | en:Jordanian dinar | ||
| Ливанский фунт | LBP | 1 USD = 1508 LBP | en:Lebanese pound | ||
| Нидерландский антильский гульден | ANG | 1 USD = 1,79 ANG | [www.centralbank.an/monetary Сайт эмитента] | ||
| Оманский риал | OMR | 2,601 USD = 1 OMR | en:Omani rial | ||
| Катарский риал | QAR | 1 USD = 3,64 QAR | en:Qatari riyal | ||
| Саудовский риял | SAR | 1 USD = 3,75 SAR | en:Saudi riyal | ||
| Боливар фуэрте | VEF | 1 USD = 4,3 VEF | [www.cia.gov/library/publications/the-world-factbook/fields/2116.html#ve CIA Factbook] | ||
| Доллар Каймановых островов | KYD | 1,2 USD = 1 KYD | en:Cayman Islands dollar | ||
| Бермудский доллар | BMD | 1 USD = 1 BMD | en:Bermudian dollar | ||
| Кубинское конвертируемое песо | CUC | 1 USD = 1 CUC | [www.bc.gov.cu/English/exchange_rate.asp Сайт эмитента] | ||
| Доллар того же дня | USS | 1 USD = 1 USS | |||
| Доллар следующего дня | USN | 1 USD = 1 USN | |||
| По отношению к евро (EUR) | |||||
| Боснийская конвертируемая марка | BAM | 1 EUR = 1,956 BAM | en:Bosnia and Herzegovina convertible mark | ||
| Болгарский лев | BGN | 1 EUR = 1,956 BGN | [www.bnb.bg/Statistics/StExternalSector/StExchangeRates/StERFixed/index.htm?toLang=_EN Сайт эмитента] | ||
| Литовский лит | LTL | 1 EUR = 3,453 LTL | [www.lb.lt/exchange/default.asp?lang=e Сайт эмитента] | ||
| Латвийский лат | LVL | 1 EUR = 0,7028 LVL | en:Latvian lats | ||
| Датская крона | DKK | 1 EUR = 7,46 DKK | en:Danish krone | ||
| Эскудо Кабо-Верде | CVE | 1 EUR = 110,3 CVE | en:Cape Verdean escudo | ||
| Франк Комор | KMF | 1 EUR = 492 KMF | en:Comorian franc | ||
| Франк КФА BEAC | XAF | 1 EUR = 656 XAF | en:Central African CFA franc | ||
| Франк КФА BCEAO | XOF | 1 EUR = 656 XOF | en:West African CFA franc | ||
| Французский тихоокеанский франк | XPF | 1 EUR = 119,3 XPF | [www.ieom.fr/convertisseur/convertisseur_Euro_Xpf_popup.html Сайт эмитента] | ||
| По отношению к фунту стерлингов (GBP) | |||||
| Фунт Фолклендских островов | FKP | 1 GBP = 1 FKP | en:Falkland Islands pound | ||
| Фунт Острова Мэн | (IMP) | 1 GBP = 1 IMP | en:Manx pound | ||
| Гернсийский фунт | (GGP) | 1 GBP = 1 GGP | en:Guernsey pound | ||
| Гибралтарский фунт | GIP | 1 GBP = 1 GIP | en:Gibraltar pound | ||
| Джерсийский фунт | (JEP) | 1 GBP = 1 JEP | en:Jersey pound | ||
| Фунт Святой Елены | SHP | 1 GBP = 1 SHP | en:Saint Helena pound | ||
| По отношению к южноафриканскому рэнду (ZAR) | |||||
| Лоти Лесото | LSL | 1 ZAR = 1 LSL | en:Lesotho loti | ||
| Намибийский доллар | NAD | 1 ZAR = 1 NAD | en:Namibian dollar | ||
| Свазилендский лилангени | SZL | 1 ZAR = 1 SZL | en:Swazi lilangeni | ||
| По отношению к индийской рупии (INR) | |||||
| Бутанский нгултрум | BTN | 1 INR = 1 BTN | en:Bhutanese ngultrum | ||
| Непальская рупия | NPR | 1 INR = 1,6 NPR | [www.nrb.org.np/fxmexchangerate1.php?YY=&&MM=&&DD= Сайт эмитента] | ||
| По отношению к другим валютам | |||||
| Южносуданский фунт | SSP | 1 SDG = SSP | |||
| Брунейский доллар | BND | 1 SGD = 1 BND | [ambd.gov.bn/index.php/component/content/article/19-publication/97-autoriti-monetari-brunei-darussalam-policy-statement- Сайт эмитента] | ||
| Патака Макао | MOP | 1 HKD = 1,03 MOP | [www.amcm.gov.mo/currency/Currency.htm Сайт эмитента] | ||
| Расчётная единица ADB | XUA | 1 XDR = 1 XUA | [www.afdb.org/fileadmin/uploads/afdb/Documents/Legal-Documents/Agreement%20Establishing%20the%20ADB%20final%202011.pdf Учредительный договор ADB. — ч. II, ст. 5, п. 1b] | ||
| Доллар Тувалу | (TVD) | 1 AUD = 1 TVD | |||
Курсы, зафиксированные при переходе на евро
| Валюта | Код ISO 4217 | Значение фиксированного курса | Источник |
|---|---|---|---|
| Австрийский шиллинг | ATS | 1 EUR = 13,76 ATS | |
| Бельгийский франк | BEF | 1 EUR = 40,34 BEF | |
| Немецкая марка | DEM | 1 EUR = 1,956 DEM | |
| Ирландский фунт | IEP | 1 EUR = 0,7876 IEP | |
| Испанская песета | ESP | 1 EUR = 166,4 ESP | |
| Итальянская лира | ITL | 1 EUR = 1936 ITL | |
| Люксембургский франк | LUF | 1 EUR = 40,34 LUF | |
| Нидерландский гульден | NLG | 1 EUR = 2,204 NLG | |
| Португальский эскудо | PTE | 1 EUR = 200,5 PTE | |
| Финляндская марка | FIM | 1 EUR = 5,946 FIM | |
| Французский франк | FRF | 1 EUR = 6,56 FRF | |
| Греческая драхма | GRD | 1 EUR = 340,8 GRD | |
| Словенский толар | SIT | 1 EUR = 239,6 SIT | |
| Кипрский фунт | CYP | 1 EUR = 0,5853 CYP | |
| Мальтийская лира | MTL | 1 EUR = 0,4293 MTL | |
| Словацкая крона | SKK | 1 EUR = 30,13 SKK | |
| Эстонская крона | EEK | 1 EUR = 15,65 EEK | |
| Ватиканская лира | VAL | 1 ITL = 1 VAL (1 EUR = 1936 VAL) | |
| Монегасский франк | MCF | 1 FRF = 1 MCF (1 EUR = 6,56 MCF) | |
| Санмаринская лира | SML | 1 ITL = 1 SML (1 EUR = 1936 SML) |
Прочие валюты, чей курс близок к фиксированному
См. также
- {{Обменный курс}}
Во избежание поломок страниц, использующих данный шаблон, желательно экспериментировать в своём личном пространстве.
