Калып:Валюта курсу/doc
 |
 |
Жоопкерчиликтен баш тартуу. Данные, которые транслируются описываемыми шаблонами, могут отличаться от официальных курсов, установленных центральными банками, а также от рыночных курсов, транслируемых через другие информационные каналы. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.
|
Настоящая документация описывает совместную работу нескольких шаблонов.
Основной шаблон — {{Валюта курсу}}, отвечающий за вывод данных в конечных статьях и списках (см. раздел «Примеры использования»).
Автоматически обновляемые шаблоны:
- {{Валюта курсу/Маалыматтар}} — шаблон, где собираются текущие котировки из открытых источников, которые затем использует шаблон {{Валюта курсу}};
- {{Валюта курсу/ЭВФ маалыматтары}} — шаблон, который отвечает за сбор данных по валютам, котируемым Международным валютным фондом, и транслирует их в шаблон {{Валюта курсу/Маалыматтар}};
- {{Валюта курсу/ЕББ маалыматтары}} — шаблон, который отвечает за сбор данных по валютам, котируемым Европейским центральным банком, и транслирует их в шаблон {{Валюта курсу/Маалыматтар}};
- {{Валюта курсу/КРУБ маалыматтары}} — шаблон, который отвечает за сбор данных по валютам, котируемым Кыргыз Республикасынын улуттук банкы, и транслирует их в шаблон {{Валюта курсу/Маалыматтар}}.
Вручную обновляемые шаблоны:
- {{Валюта курсу/Аныкталган курстар}} — вспомогательный шаблон, где собираются данные о фиксированных курсах, используемых затем в шаблоне {{Валюта курсу/Маалыматтар}};
- {{Валюта курсу/ЭВФ сайтындагы валюталардын аталыштары}} — вспомогательный шаблон, необходимый для работы шаблона {{Валюта курсу/ЭВФ маалыматтары}}.
Все вместе они позволяют отображать в статьях, списках и других шаблонах текущий (автоматически обновляемый не реже одного раза в сутки) валютный курс практически по всем существующим валютам, имеющим код ISO 4217.
Примеры использования
[булагын түзөтүү]- Примеры простого использования
Для вывода курса нужно знать коды ISO 4217 той валютной пары, чье соотношение необходимо вывести.
| Шаблон | Результат | Примечания |
|---|---|---|
| {{Валюта курсу|KGS|USD}} | 64,1 | 1 USD = 64,1 KGS |
| {{Валюта курсу|USD|KGS}} | 0,0156 | 1 KGS = 0,0156 USD |
| {{Валюта курсу|KGS|EUR}} | 67,75 | 1 EUR = 67,75 KGS |
| {{Валюта курсу|EUR|KGS}} | 0,01476 | 1 KGS = 0,01476 EUR |
| {{Валюта курсу|KGS|GBP}} | 93,74 | 1 GBP = 93,74 KGS |
| {{Валюта курсу|GBP|KGS}} | 0,01067 | 1 KGS = 0,01067 GBP |
| {{Валюта курсу|USD|EUR}} | 1,057 | 1 EUR = 1,057 USD |
| {{Валюта курсу|EUR|USD}} | 0,9461 | 1 USD = 0,9461 EUR |
- Примеры использования с множителем и параметром «дата»
Шаблон позволяет выводить дату, которой соответствуют данные, а также использовать множитель для сокращения числа нулей.
| Шаблон | Результат | Примечания |
|---|---|---|
| {{Валюта курсу|GBP|KGS}} | 0,01067 | 1 KGS = 0,01067 GBP |
| {{Валюта курсу|GBP|KGS|1}} | 0,01067 | 1 KGS = 0,01067 GBP |
| {{Валюта курсу|GBP|KGS|10}} | 0,1067 | 10 KGS = 0,1067 GBP |
| {{Валюта курсу|GBP|KGS|100}} | 1,067 | 100 KGS = 1,067 GBP |
| {{Валюта курсу|KGS|Дата}} | 10 Апрель 2015 | Дата, которой соответствуют данные |
- Примеры, когда код валюты неизвестен шаблонам или данные о ней в шаблонах отсутствуют
Если валюта неизвестна шаблону (сведения о ней отсутствуют в шаблонах {{Валюта курсу/Маалыматтар}} и {{Валюта курсу/Аныкталган курстар}}), то результат будет пустым.
| Шаблон | Результат | Примечания |
|---|---|---|
| {{Валюта курсу|КОД|EUR}} | Результат пустой | |
| {{Валюта курсу|EUR|КОД}} | Результат пустой | |
| {{Валюта курсу|XXX|EUR}} | Результат пустой | |
| {{Валюта курсу|EUR|XXX}} | Результат пустой | |
| {{Валюта курсу|КОД|Дата}} | Дата для неизвестной валюты также будет пустой | |
| {{Валюта курсу|XXX|Дата}} | Дата для неизвестной валюты также будет пустой |
- См. также примеры использования в таких статьях, списках и шаблонах, как
Техническая реализация
[булагын түзөтүү]Порядок взаимодействия шаблонов
[булагын түзөтүү]Курсы валютных пар рассчитываются автоматически на основе данных, собираемых и обновляемых роботом KrBot из трёх источников (см. раздел «Источники данных»):
- котировки Международного валютного фонда;
- котировки Европейского центрального банка;
- котировки Центрального банка Российской Федерации.
Ручное изменение данных не требуется и не рекомендуется.
Курсы для валют, имеющих жёсткую привязку к другим валютам, автоматически вычисляются как кросс-курсы на основе вручную прописанных статических данных шаблона {{Валюта курсу/Аныкталган курстар}} и динамических данных из шаблона {{Валюта курсу/Маалыматтар}}. В случае изменения курсового режима или значения фиксированного курса, необходимо внести соответствующие изменения в шаблон {{Валюта курсу/Аныкталган курстар}}.
Параметры выводимых курсов и отказ от ответственности
[булагын түзөтүү]Выводимые настоящими шаблонами курсы основаны на открытых источниках и транслируются с округлением до четырёх значимых цифр. Они могут отличаться от официальных котировок, установленных центральными банками, они могут отличаться от курсов, транслируемых другими источниками информации. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.
Вопросы и предложения
[булагын түзөтүү]В разработке шаблонов принимали участие несколько человек, поэтому для вопросов и предложений рекомендуется использовать страницу обсуждения шаблона «Валюта курсу».
Не рекомендуется поднимать вопросы, обсуждавшиеся на страницах «Калып:Ф» и «Обсуждение шаблона:Валюта курсу», без достаточных на то оснований и появления новых весомых аргументов, которые не были рассмотрены участниками.
Источники данных
[булагын түзөтүү] |
Көңүл буруңуз! Вы поможете проекту, если предложите источники данных лучше существующих! |
Шаблон «Валюта курсу/Маалыматтар»
[булагын түзөтүү]Источниками данных для работы шаблонов, отвечающих за вывод валютных курсов являются:
- Эл аралык валюта фонду — [1];
- Европа борбордук банкы — [2];
- Кыргыз Республикасынын улуттук банкы — [3].
К сожалению, используемые источники на дают полного набора валютных пар. Мы будем благодарны, если вы предложите источник с лучшими характеристиками.
Требования к источнику информации следующие — он должен:
- Предоставлять информацию об актуальных курсах по соизмеримому (не менее 100 валют) или большему числу валют с частотой обновления не реже одного раза в неделю.
- Предоставлять данные по лицензиям, используемым в Википедии (Creative Commons Attribution/Share-Alike 3.0 и GFDL).
- В полной мере соответствовать требованиям, предъявляемым к источникам, которые принято использовать для подготовки статей «Википедии».
- Предоставлять удобный интерфейс для автоматического забора данных.
Шаблон «Валюта курсу/Аныкталган курстар»
[булагын түзөтүү]Данные шаблона {{Валюта курсу/Аныкталган курстар}} (фиксированные курсы, а также курсы с очень узким коридором) приведены со ссылкой на сайты эмитентов или другие языковые разделы «Википедии», прежде всего английский. Данные источники не вполне удобны для автоматического отслеживания, поэтому мы будем признательны, если вы предложите более удачный источник.
Текущие фиксированные курсы
[булагын түзөтүү]Курсы, зафиксированные при переходе на евро
[булагын түзөтүү]| Валюта | Код 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 = 1 936 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 = 1 936 VAL) | |
| Монегасский франк | MCF | 1 FRF = 1 MCF (1 EUR = 6,56 MCF) | |
| Санмаринская лира | SML | 1 ITL = 1 SML (1 EUR = 1 936 SML) |
Прочие валюты, чей курс близок к фиксированному
[булагын түзөтүү]См. также
[булагын түзөтүү]- {{Обменный курс}}