Шаблон:Start and end dates/doc

Назначение шаблона {{start and end dates}} — возвращать диапазон дат, в течение которых произошло событие или существовала сущность. Он также включает дубликат, машиночитаемую дату (или дату-время) в формате даты ISO (которая скрыта CSS), для использования внутри других шаблонов (или строк таблицы), которые выдают микроформаты. Она должна использоваться только один раз в каждом таком шаблоне и никогда не использоваться вне таких шаблонов. Скрытая дата изящно деградирует, когда CSS недоступен.

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

Когда не следует использовать этот шаблон

Не используйте этот шаблон для:

• дат, которые являются неопределенными, например, «до 4 апреля 1933 года»; «около 18 ноября 1939 года»;
• дат за пределами диапазона, указанного в разделе «Ограничение», ниже;
• других, второстепенных дат;
• вне шаблонов, издающих микроформат — если есть сомнения, обратитесь к документации родительского шаблона;
• более одной даты в любом родительском шаблоне.

Синтаксис

{{start and end dates|year|month|day|year|month|day}}

Примеры

• Стандартный: {{start and end dates|1939|9|1|1945|9|2}} → 1 сентября 1939 — 2 сентября 1945 (1939-09-01 — 1945-09-02)
• Тот же год: {{start and end dates|1939|9|1|1939|10|2}} → 1 сентября — 2 октября 1939 (1939-09-01 — 1939-10-02)
• Тот же месяц и год: {{start and end dates|1939|9|1|1939|9|2}} → 1—2 сентября 1939 (1939-09-01 — 1939-09-02)
• Текущий диапазон: {{start and end dates|1939|9|1|present}} → 1 сентября 1939 — настоящее (1939-09-01 — настоящее)

Параметры

Здесь приведена документация в формате TemplateData для данного шаблона, которая используется в TemplateWizard, визуальном редакторе и прочих инструментах. Смотрите ежемесячный отчет об использовании параметров этого шаблона в статьях.

Дата начала или создания события или сущности и дата его окончания или уничтожения

Параметры шаблона

Параметр		Описание	Тип	Статус
YYYY	1	Год начала Пример 1939	Число	необязательный
MM	2	Месяц начала Пример 9	Число	необязательный
DD	3	День начала Пример 1	Число	необязательный
YYYY	4	Год конца Пример 1945	Число	необязательный
MM	5	Месяц конца Пример 9	Число	необязательный
DD	6	День конца Пример 2	Число	необязательный

Использование в микроформатах

Этот шаблон также возвращает дату, скрытую с помощью CSS, в формате ISO 8601, необходимом для одного или нескольких следующих микроформатов:

• hAtom (class="updated")
• hAudio (class="published")
• hCalendar (class="dtstart")
• hCard (class="bday")

обычно, но не всегда, внутри инфобокса или подобных шаблонов, или таблиц.

В hCard он используется для организаций, мест проведения мероприятий и тому подобного; для людей используйте {{ДатаРождения}} или {{Родился}}.

Аналогично, {{End date}} возвращает дату как у hCalendar (class="dtend").

Более подробную информацию смотрите в проекте микроформаты.

Ограничение

В этом шаблоне нет положений для работы с датой не по григорианскому календарю. Кроме того, ISO 8601 требует взаимного согласия между теми, кто обменивается информацией, перед использованием годов вне диапазона 1583-9999 CE. Поэтому использование этого шаблона для негригорианских дат или дат вне этого диапазона представляет собой ложное заявление о соответствии стандарту ISO 8601.

Любой редактор, столкнувшийся с таким использованием, должен изменить дату на обычный текст без шаблона; или, если вы не уверены в этом, поднять этот вопрос на странице обсуждения этого шаблона.

См. также

• {{Age in years and days}} — вычисление промежутка времени между датами.