Шаблон:Валюта
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
 | Этот шаблон используется примерно на 4400 страницах , и изменения могут быть широко замечены. Протестируйте изменения на подстраницах шаблона /sandbox или /testcases или на вашей собственной подстранице пользователя . Рассмотрите возможность обсуждения изменений на странице обсуждения перед их реализацией. |
 | Этот шаблон использует Lua : |
| Связанные страницы |
|---|
|
Форматирует значение валюты с соответствующим символом, который связан со статьей о валюте. Если валюта не указана, шаблон покажет сумму в долларах США .
Использование
Использование неименованных параметров:
{{currency|value|code|first=|linked=|fmt=|passthrough=}}
Использование именованных параметров:
{{currency|amount=value|code=code|first=|linked=|passthrough=}}
где:
- значение — число с запятыми-разделителями или без них; за ним может следовать необязательный квантификатор: «тысяча», «миллион», «М», «миллиард», «Б» или «триллион».
- code — это код валюты ISO 4217 или один из поддерживаемых нестандартных кодов, перечисленных ниже.
|first=при установке любого значения выводится полное название валюты|linked=при установке наnoотключает викиссылки на отображаемый символ валюты или полное название валюты|fmt=определяет, как разделяются группы цифр значений :commas(по умолчанию) разделяет группы цифр значений запятыми; это значение по умолчанию, то же самое, что и в случае, когда|fmt=параметр пуст или пропущенgapsразделяет группы цифр значений узкими пробелами.noneотображает значение без группировки цифр.
|passthrough=указывает, должен ли шаблон пытаться анализировать число в соответствии с|fmt=или просто вставлять любую строку, указанную|amount=непосредственно после знака валюты. Должен иметь значение либо|passthrough=yesлибо|passthrough=no
При использовании имен параметров предпочтительны |amount=и |code=. Шаблон также примет |Amount=и |type=и |Type=хотя.
Примечание: использование как именованных, так и неименованных параметров может привести к неожиданным результатам. В этом примере шаблон ожидает, что первый неименованный параметр будет числом значения:
{{Currency|amount=1000|GBP}}- {{currency}} – неверная сумма ( помощь )
- используйте
{{Currency|1000|GBP}}или{{Currency|amount=1000|code=GBP}}, оба варианта дают 1000 фунтов стерлингов .
Поддерживаемые нестандартные коды валют
Коды, которые можно перевести в валюты ISO 4217
Эти нестандартные коды являются псевдонимами стандартных кодов ISO 4217 .
- ЕГЭ
- Евросоюз
- ЕВРО
- ФРВ
- КШ
- НЭП
- ФУНТ
- ФУНТ СТЕРЛИНГОВ
- юаней
- СТЕРЛИНГ
- СТГ
- ТТГ
- Великобритания
- СОЕДИНЕННЫЕ ШТАТЫ
- НАС
- НАС
- США
- УШ
Другие нестандартные коды
Эти коды либо не имеют соответствующего кода валюты ISO 4217, либо являются альтернативными версиями существующих кодов ISO 4217 или поддерживают уникальные аспекты валюты.
- БИТКОИН – нет соответствующего кода ISO 4217
- BTC – нет соответствующего кода ISO 4217
- DKK2 – альтернативная версия DKK
- ФРФ – исторический
- GRD – исторический
- LSL2 – множественное число от LSL
- ЛИТ – исторический
- NOK2 – альтернативная версия NOK
- SEK2 – альтернативная версия SEK
- SZL2 – множественное число от SZL
- US$ — особый случай: как стандартные коды «USD» (и «$»), но вместо более длинного «US$» отображается только «$» (для статей, где отображение «US$» может показаться неуместно длинным, но шаблон все равно должен ссылаться на «доллар США», чтобы избежать какой-либо двусмысленности)
- XBT – нет соответствующего кода ISO 4217
Примеры
Валюты, отличные от доллара США, могут быть отображены с использованием соответствующего кода валюты ISO 4217.
{{Currency|1000|BMD}}дает: 1000 BD$ за бермудский доллар{{Currency|1000|BDT}}дает: ৳ 1000 для бангладешских така{{Currency|1000|AMD}}дает: ֏ 1000 для армянских драмов
Некоторые из наиболее известных валют также предоставляют возможность использовать общепринятые сокращения или полные названия.
{{Currency|1000|US}}дает: 1000 долларов США{{Currency|1000|United States}}дает: 1000 долларов США{{Currency|1,000|JPY}}дает: ¥ 1000
При желании можно также использовать имена параметров:
{{Currency|amount=1000|code=US}}дает: 1000 долларов США{{Currency|1000|code=euro}}дает: € 1000
Отрицательная сумма:
{{Currency|amount=-1000|code=US}}дает: −1000 долл. США
Текстовые квантификаторы:
{{Currency|1000 million|code=euro}}дает: € 1,000,000,000{{Currency|1000M|code=euro}}дает: € 1,000,000,000
При первом использовании валюты следует указать ее значение и полное название, поэтому, если определен параметр «first», то именно он и будет указан.
{{Currency|1000|cve|first=yes}}дает: 1000 эскудо Кабо-Верде{{Currency|1000|cve}}дает: 1.000 $ 00
Поскольку символы валют DKK, NOK и SEK могут быть неоднозначными, их можно представить двумя способами:
- Для датских крон:
{{Currency|1000|dkk}}дает: 1000 крон{{Currency|1000|dkk2}}дает: 1000 датских крон
- Для норвежских крон:
{{Currency|1000|NOK}}дает: 1000 крон{{Currency|1000|NOK2}}дает: 1000 норвежских крон
- Для шведских крон:
{{Currency|1000|SEK}}дает: 1000 крон{{Currency|1000|SEK2}}дает: 1000 шведских крон
Аналогично, некоторые валюты используют разные символы для обозначения единичных и множественных сумм:
Группировка цифр:
|fmt=commas{{Currency|1000 million|code=euro|fmt=commas}}дает: € 1,000,000,000
|fmt=gaps{{Currency|1000 million|code=euro|fmt=gaps}}дает: € 1 000 000 000
|fmt=none{{Currency|1000 million|code=euro|fmt=none}}дает: € 1000000000
Проход:
|passthrough=yes|passthrough=no{{Currency|6 million|PHP|passthrough=no}}дает: ₱ 6,000,000{{Currency|6 trillion|PHP|passthrough=no}}дает: ₱ 6,000,000,000,000{{Currency|6 tn|PHP|passthrough=no}}выдает: {{currency}} – недопустимая сумма ( помощь ) (ожидается ошибка, так как шаблон не знает, как выполнить6 tnпарсинг6,000,000,000,000)
- Используйте экономно! Обычно
|fmt=вместо этого вы хотите.|passthrough=следует использовать только способами, совместимыми с MOS:CURRENCY .
Сообщения об ошибках
{{currency}}может выдать несколько сообщений об ошибках. Это:
- {{currency}} – недопустимый код – значение во втором неименованном параметре или назначенное
|code=не может быть найдено в списке кодов шаблона. Убедитесь, что назначенный код является правильным кодом валюты ISO 4217 или одним из поддерживаемых нестандартных кодов, перечисленных выше. - {{currency}} – недопустимая сумма – значение в первом неименованном параметре или назначенное
|amount=содержит один или несколько символов, которые не являются знаком минус, цифрой, запятой или десятичной точкой, или содержит текст, который не является одним из разрешенных квантификаторов. Убедитесь, что разделители-запятые группируют три цифры и что число имеет только одну десятичную точку. Убедитесь, что параметры сумма и код либо оба именованы (|amount=и|code=), либо оба неименованы. - {{currency}} – определение отсутствует позиция – внутренняя ошибка, которая должна возникать только тогда, когда редактор возится с Module:Currency/Presentation . Она указывает на то, что Module:Currency не знает, где разместить символ валюты по отношению к ее значению.
- {{currency}} – определение отсутствует на странице – внутренняя ошибка, которая должна возникать только тогда, когда редактор возится в Module:Currency/Presentation. Она указывает на то, что у Module:Currency нет страницы, которую можно использовать для ссылки на символ или название валюты.
TemplateData
TemplateData для валюты
Используйте этот шаблон, чтобы указать связанный символ валюты и сумму наличных денег.
| Параметр | Описание | Тип | Статус | |
|---|---|---|---|---|
| Количество | 1 amount Amount | Значение в указанной валюте | Линия | необходимый |
| Валюта | 2 code type Type | Представленная валюта. Должен быть действительным кодом ISO 4217 или одним из специальных кодов, перечисленных на странице шаблона.
| Линия | предложенный |
| Длинная форма | first | При установке любого значения выдает длинное название валюты. Это следует использовать для первого упоминания валюты в статье | Линия | необязательный |
| Ссылка валюты | linked | Ссылаться ли на статью по этой валюте. «нет» подавляет ссылку, любое другое значение отображает ее.
| Линия | необязательный |
| Формат | fmt | Указывает, как разделяются группы цифр значений: запятыми, пробелами или без них.
| Линия | необязательный |
| Проходной | passthrough | Если «да», поместите строку в Amount непосредственно после ее символа, не превращая ее в число.
| Линия | необязательный |
Смотрите также
- Википедия:Руководство по стилю (даты и числа)#Валюты для получения важных инструкций по использованию.
- {{ Format price }} — шаблон, который обрабатывает округление и форматирование «больших чисел»
- {{ Инфляция }} — шаблон, который корректирует исторические затраты до текущей (или эквивалентной стоимости другого года) стоимости
{{Infobox currency}}
