Шаблон: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, визуальном редакторе и прочих инструментах. Смотрите ежемесячный отчет об использовании параметров этого шаблона в статьях.

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

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

ПараметрОписаниеТипСтатус
YYYY1

Год начала

Пример
1939
Числонеобязательный
MM2

Месяц начала

Пример
9
Числонеобязательный
DD3

День начала

Пример
1
Числонеобязательный
YYYY4

Год конца

Пример
1945
Числонеобязательный
MM5

Месяц конца

Пример
9
Числонеобязательный
DD6

День конца

Пример
2
Числонеобязательный

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

[править код]

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

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

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

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

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

Ограничение

[править код]

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

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

См. также

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