Шаблон:доллар США

АМЕРИКАНСКИЙ ДОЛЛАР$

Документация по шаблону [ просмотр ] [ правка ] [ история ] [ очистка ]

Соответствующее обсуждение на

→ Обсуждение шаблона:Валюта#Предложения по стандартному набору опций для каждого шаблона

Ярлыки

{{ ДОЛЛАР США }}
{{ АМЕРИКАНСКИЙ ДОЛЛАР$ }}

Этот шаблон используется примерно на 13 000 страниц , и изменения могут быть широко замечены. Протестируйте изменения на подстраницах шаблона /sandbox или /testcases или на вашей собственной подстранице пользователя . Рассмотрите возможность обсуждения изменений на странице обсуждения перед их реализацией.

Это многофункциональный шаблон. В самом простом варианте он добавляет денежный знак "US$", как рекомендует MOS:CURRENCY для многих ситуаций. Шаблон также может ссылаться на статью о долларе США и даже может рассчитывать инфляцию. См. предупреждения ниже в § Расчет инфляции.

Использование

{{US$|number}}

Дополнительный текст, например «миллион» или «триллион», необходимо разместить за пределами шаблона, обычно с предваряющим его неразрывным пробелом (см. пример ниже).

Пример:

{{US$}}→ долл. США
{{US$|123.45}}→ 123,45 долл. США
{{US$|123}}{{nbsp}}million→ 123 миллиона долларов США

Связь

Параметр |link=yesможет использоваться для привязки US$ к статье United States dollar . По умолчанию это отключено, но может быть уместно для первого появления термина в статье.

Пример:

{{US$|123.45|link=yes}}→ 123,45 долл. США

Подавить «США»

Указав |long=no, можно подавить отображение «US» перед знаком «$», когда из контекста ясно, что подразумевается доллар США , а не одна из двадцати или около того других валют, известных под названием « доллар ».

Примеры:

{{US$|123.45|long=no}}→ $123.45
{{US$|123.45|long=no|link=yes}}→ $ 123.45

Расчет инфляции

Этот шаблон способен только завышать значения индекса потребительских цен: основные продукты, арендная плата рабочих, мелкие счета за услуги (расходы на врачей, билеты на поезд). Этот шаблон не способен завышать капитальные расходы, государственные расходы или личное богатство и расходы богатых; для этих целей см. . Неправильное использование этого шаблона будет представлять собой оригинальное исследование . Если вы не уверены и у вас нет экономического образования, то, пожалуйста, проконсультируйтесь с тем, у кого оно есть, прежде чем использовать этот шаблон.{{Inflation}}

Не думайте, что использование этого шаблона будет означать, что вычисленное значение является "текущим" , "по состоянию на 2025 год" , "по состоянию на 2024 год" или даже обязательно "недавним" . Не используйте {{CURRENTYEAR}}для ссылки на вычисленное значение, вместо этого можно использовать. См. также MOS:REALTIME .{{Inflation/year|US}}

Шаблон поддерживает расчет инфляции посредством . Если используется второй параметр для указания года, и этот год находится в определенном диапазоне доступных данных по инфляции (в частности, если 1634 ≤ < 2023 ), эквивалентное значение, представленное в долларах 2023 года, будет рассчитано в скобках. Однако эту функцию следует использовать только в соответствующих ситуациях.{{Inflation}}year

{{US$|value|year}}
{{US$|value|year|round=round|about=yes}}

Примеры:

{{US$|100|1633}}→ 100 долларов США
{{US$|100|1634}}→ 100 долларов США (эквивалент 1019 долларов США в 2023 году)
{{US$|100|1966}}→ 100 долларов США (эквивалентно 939,08 долларам США в 2023 году)
{{US$|100|1966|link=yes}}→ 100 долларов США (эквивалентно 939,08 долларам США в 2023 году)
{{US$|100|2022}}→ 100 долларов США (эквивалент 104,12 долларов США в 2023 году)
{{US$|100|2023}}→ 100 долларов США
{{US$|100|2025}}→ 100 долларов США
{{US$|100|2026}}→ 100 долларов США

Дополнительный параметр |about=yesзаставит шаблон вычислять до ближайшего доллара (вместо ближайшего цента) и добавлять к вычисленному значению префикс "примерно". Округление можно дополнительно настроить с помощью . Эти параметры можно комбинировать.|round=integer

Примеры:

{{US$|10|1935}}→ 10 долларов США (эквивалентно 222,23 доллара США в 2023 году)
{{US$|10|1935|round=0}}→ 10 долларов США (эквивалентно 222 долларам США в 2023 году)
{{US$|10|1935|about=yes}}→ 10 долларов США (что эквивалентно примерно 222 долларам США в 2023 году)
{{US$|1000|1935|round=2}}→ 1000 долларов США (что эквивалентно 22 223,3 доллара США в 2023 году)
{{US$|1000|1935|round=-2}}→ 1000 долларов США (что эквивалентно 22 200 долларам США в 2023 году)
{{US$|1000|1935|round=-2|about=yes}}→ 1000 долларов США (что эквивалентно примерно 22 200 долларам США в 2023 году)

Осторожность: Код расчета инфляции приводит к тому, что этот шаблон приближается к пределу глубины расширения в 40 в программном обеспечении, которое обеспечивает работу Википедии. Страницы, превышающие этот предел, помещаются в Category:Pages, где глубина расширения превышена . Использование |about=yesможет несколько снизить воздействие. Если вы вызываете этот шаблон из другого шаблона и используете функцию инфляции, рассмотрите возможность добавления предупреждения, аналогичного этому, на страницу документации этого шаблона.

Показать год

Параметр |showyear=yesможет использоваться для отображения in YYYYсоотношения между суммой и инфляцией. Это используется для структурирования предложения.

Пример:

{{US$|100|1850}}→ 100 долларов США (эквивалентно 3662 долларам США в 2023 году)
{{US$|100|1850|showyear=yes}}→ 100 долларов США в 1850 году (эквивалентно 3662 долларам США в 2023 году)

Перенаправляется сюда

Шаблон:USD

Смотрите также

Шаблон данных

Это TemplateData для этого шаблона, используемого TemplateWizard, VisualEditor и другими инструментами. См. ежемесячный отчет об использовании параметров для Template:US dollar в статьях, основанных на его TemplateData.

TemplateData для доллара США

Это многофункциональный шаблон. В самом простом варианте он добавляет денежный знак "US$", как рекомендует MOS:CURRENCY для многих ситуаций. Шаблон также может ссылаться на статью о долларе США и даже может рассчитывать инфляцию.

Параметры шаблона [ Редактировать данные шаблона ]
В этом шаблоне предпочтение отдается встроенному форматированию параметров.
Параметр		Описание	Тип	Статус
Количество	`1`	Сумма в долларах США	Число	необходимый
Год	`2`	Укажите год, и если этот год находится между 1800 и текущим годом минус 1, в скобках будет рассчитано значение с поправкой на инфляцию.	Число	предложенный
Связь?	`link`	Ссылка US$ на статью Пример да	Булев	предложенный
О?	`about`	Если да, рассчитайте с точностью до доллара (вместо цента) и добавьте к вычисленному значению префикс «примерно». Пример да	Булев	необязательный
Десятичные точки	`round`	Целое число, округленное до указанного количества десятичных знаков, используйте отрицательное число (например, -2) для значащих цифр Пример 2	Число	предложенный
АМЕРИКАНСКИЙ ДОЛЛАР$?	`long`	Если нет, отображение «US» перед знаком «$» будет подавлено, когда из контекста ясно, что имеется в виду доллар США, а не одна из двадцати или около того других валют, известных под названием «доллар». Пример нет	Булев	необязательный
Показать год?	`showyear`	Если да, укажите «в ГГГГ» между суммой и расчетом инфляции. Пример да	Булев	необязательный

Вышеуказанная документация включена из Template:US dollar/doc . ( могут экспериментировать на страницах sandbox и testcases этого шаблона . Добавьте категории на подстраницу /doc . Подстраницы этого шаблона .