Редактирование: Модуль:Срок/doc

{{doc}}
== Описание модуля ==
'''Модуль:Срок''' предназначен для автоматического расчёта времени, прошедшего с момента открытия или основания объекта (транспортной системы, линии, депо, предприятия и т.п.) до сегодняшнего дня или даты закрытия.

=== Механизм работы ===
# Модуль автоматически удаляет квадратные скобки вики-ссылок (<code><nowiki>[[20 мая]] [[2024|2024 года]]</nowiki></code>), HTML-комментарии и слова «года/г.».
# Принимает текстовые даты (<code>20 мая 2024</code>), цифровые (<code>20.05.2024</code>, <code>2024-05-20</code>), а также неполные даты (<code>май 2024</code> или <code>2024</code>).
# Модуль вычисляет разницу строго по календарным границам с учётом високосных годов. Если текущий день месяца меньше дня открытия, дни корректно заимствуются из предыдущего месяца без погрешностей усреднения.
# Автоматически подставляет грамматические формы (''1 год / 2 года / 5 лет'', ''1 месяц / 4 месяца / 7 месяцев'', ''1 день / 3 дня / 12 дней'').

== Примеры использования ==

=== 1. Внутри шаблона-карточки (инфобокса) ===
В коде шаблона карточки (например, <code>Шаблон:Метрополитен</code>):
<pre>
|метка5 = Дата открытия
|текст5 = {{#if: {{{дата открытия|}}} | {{{дата открытия}}}{{#if: {{#invoke:Срок|diff|{{{дата открытия}}}|{{{дата закрытия|}}}}} | <br><small style="color: #57606a;">({{#invoke:Срок|diff|{{{дата открытия}}}|{{{дата закрытия|}}}}})</small> }} }}
</pre>

'''Как это выглядит в карточке статьи:'''
* Действующая система (<code>|дата открытия = 20 мая 2024</code>):
*> '''Дата открытия:''' 20 мая 2024<br><small style="color: #57606a;">(действует 2 года, 3 месяца и 22 дня)</small>
* Закрытая система (<code>|дата открытия = 10 мая 1995</code>, <code>|дата закрытия = 15 октября 2012</code>):
*> '''Дата открытия:''' 10 мая 1995<br><small style="color: #57606a;">(проработал 17 лет, 5 месяцев и 5 дней)</small>

=== 2. Внутри связного текста статьи ===
<pre>
Муроморский скоростной трамвай был запущен в эксплуатацию [[9 мая]] [[2024 года]] 
({{#invoke:Срок|diff|9 мая 2024}}).
</pre>
'''Как это выглядит:'''
> Муроморский скоростной трамвай был запущен в эксплуатацию 9 мая 2024 года (действует 2 года, 4 месяца и 2 дня).

=== 3. Внутри таблиц и информационных блоков ===
Если требуется вывести только интервал без префиксов «действует/проработал»:
<pre>
{| class="wikitable"
! Маршрут !! Открыт !! Возраст маршрута
|-
| Трамвай №1 || 9 мая 2024 || {{#invoke:Срок|diff|9 мая 2024|только_число=да}}
|-
| Трамвай №5 || 8 августа 2026 || {{#invoke:Срок|diff|8 августа 2026|только_число=да}}
|}
</pre>

'''Как это выглядит:'''
{| class="wikitable" style="font-size: 13px;"
! Маршрут !! Открыт !! Возраст маршрута
|-
| Трамвай №1 || 9 мая 2024 || 2 года, 4 месяца и 2 дня
|-
| Трамвай №5 || 8 августа 2026 || 1 месяц и 3 дня
|}

=== 4. Отключение отображения дней ===
Если точность до дней избыточна:
<pre>
{{#invoke:Срок|diff|20 мая 2024|без_дней=да}}
</pre>
''"{{#invoke:Срок|diff|20 мая 2024|без_дней=да}}"''

[[Категория:Модули]]
</noinclude>

=== 5. Всплывающая подсказка при наведении ===
Позволяет не перегружать интерфейс карточки лишним текстом: дата остаётся аккуратной и компактной, а точный отсчёт времени (лет, месяцев и дней) отображается в нативной всплывающей подсказке браузера при наведении курсора на дату.

Дата помечается тонким пунктирным подчёркиванием снизу, а курсор меняется на справочный (`?` / `help`).

Поведение подсказки:
* При наведении на дату открытия действующей системы всплывает: ''«действует X лет, Y месяцев и Z дней»'' (для закрытой — ''«проработал...»'').
* При наведении на дату закрытия всплывает общий срок эксплуатации: ''«Срок работы: X лет, Y месяцев и Z дней»''.

'''Код для шаблона-карточки:'''
<pre>
|метка5 = Дата открытия
|текст5 = {{#if: {{{дата открытия|}}} | {{#if: {{#invoke:Срок|diff|{{{дата открытия}}}|{{{дата закрытия|}}}}} | <abbr title="{{#invoke:Срок|diff|{{{дата открытия}}}|{{{дата закрытия|}}}}}" style="text-decoration: none; border-bottom: 1px dashed #8c959f; cursor: help;">{{{дата открытия}}}</abbr> | {{{дата открытия}}} }} }}

|метка6 = Дата закрытия
|текст6 = {{#if: {{{дата закрытия|}}} | {{#if: {{#invoke:Срок|diff|{{{дата открытия|}}}|{{{дата закрытия}}}}} | <abbr title="Срок работы: {{#invoke:Срок|diff|{{{дата открытия|}}}|{{{дата закрытия}}}|только_число=да}}" style="text-decoration: none; border-bottom: 1px dashed #8c959f; cursor: help;">{{{дата закрытия}}}</abbr> | {{{дата закрытия}}} }} }}
</pre>

'''Использование в обычном тексте статьи:'''
<pre>
Движение было открыто <abbr title="{{#invoke:Срок|diff|20 мая 2024}}" style="border-bottom: 1px dashed #8c959f; cursor: help;">20 мая 2024 года</abbr>.
</pre>

''"Движение было открыто <abbr title="{{#invoke:Срок|diff|20 мая 2024}}" style="border-bottom: 1px dashed #8c959f; cursor: help;">20 мая 2024 года</abbr>".''

=== 6. Нейтральный отсчёт (для городов, населённых пунктов и событий) ===
Для объектов, к которым не подходит транспортное слово «действует» (города, крепости, памятники, исторические события, битвы или конференции), предусмотрены нейтральные формулировки.

'''Для городов и поселений''' (<code>|тип=город</code> или <code>|тип=нп</code>):
* Действующий город: ''«существует 323 года»''
* Заброшенный/упразднённый город: ''«просуществовал 142 года»''
'''Для событий и годовщин''' (<code>|нейтрально=да</code> или <code>|тип=событие</code>):
* Прошедшее событие: ''«прошло 80 лет, 4 месяца и 2 дня»''
* Длившийся процесс (при указании даты окончания): ''«продлилось 3 года и 1 месяц»''
'''Относительный формат''' (<code>|режим=назад</code>):
* Выводит: ''«2 года, 3 месяца и 15 дней назад»''
'''Собственный префикс и суффикс''' (<code>|префикс=...</code>, <code>|суффикс=...</code>):
* <code><nowiki>{{#invoke:Срок|diff|1147|префикс=возраст Москвы: }}</nowiki></code> → ''возраст Москвы: 879 лет''

==== Примеры вызова в тексте ====
* <code><nowiki>{{#invoke:Срок|diff|1703|тип=город}}</nowiki></code> → {{#invoke:Срок|diff|1703|тип=город}}
* <code><nowiki>{{#invoke:Срок|diff|12 апреля 1961|нейтрально=да}}</nowiki></code> → {{#invoke:Срок|diff|12 апреля 1961|нейтрально=да}}
* <code><nowiki>{{#invoke:Срок|diff|9 мая 1945|режим=назад}}</nowiki></code> → {{#invoke:Срок|diff|9 мая 1945|режим=назад}}

==== Использование в шаблоне населённого пункта ({{tl|НП}}) ====
Для всплывающей подсказки в карточке населённого пункта над полем «Основан»:
<pre>
|метка13 = Основан
|текст13 = {{#if: {{{дата основания|}}} | {{#if: {{#invoke:Срок|diff|{{{дата основания}}}|тип=город}} | <abbr title="{{#invoke:Срок|diff|{{{дата основания}}}|тип=город}}" style="text-decoration: none; border-bottom: 1px dashed #8c959f; cursor: help;">{{{дата основания}}}</abbr> | {{{дата основания}}} }} }}
</pre>