Справка: функция времени

Эта страница справки представляет собой практическое руководство . В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не одна из политик или рекомендаций Википедии , и может отражать различные уровни консенсуса и проверки .

Ярлык H: TF

Функция времени или #time - это функция парсера MediaWiki для отображения даты / времени в других форматах. Например ( очистить для обновления):

• {{#time:j F Y}}                shows: 25 April 2021, the current UTC date
• {{#time:F j, Y}}               shows: April 25, 2021, the current date in mdy format
• {{#time:Y-m-d}}                shows: 2021-04-25, current ISO 8601 date
• {{#time:H:i:s}}                shows: 12:20:32, current time-of-day
• {{#time:l}}                    shows  "Sunday" as current day of week
• {{#time:\d\a\y D}}             shows  "day Sun" as current 3-letter day
• {{#time:j. F Y|7 May 2013|de}} shows  "7. Mai 2013" as a date in German
• {{#time:xij xiF xiY}}          shows  "5 Ordibehesht 1400" as current date in Iranian calendar

Существует более 35 кодов формата даты (см. Ниже: Коды формата времени ) для перестановки день-месяц-год или час-минута-секунда (например, 'j' для дня, 'H' для часа или el 'l' показать день недели). Другие буквы обрабатываются как буквальный текст или используют обратную косую черту для экранирования формата ( '\d'показывает 'd'). Параметр 2 может обозначать другую дату / время (в любом из нескольких типичных форматов), в то время как двухбуквенный языковой код может быть указан в качестве параметра 3 для перевода названия месяца на другой язык.

Помимо григорианского календаря , функция #time может также преобразовывать дату в некоторые другие календари , используя x-коды (x_): исламский (xm), иранский (xi), иврит (xj), тайский (xk), Minguo (xo). ) или по японскому календарю (xt). Например, чтобы показать исламскую дату в виде месяца и года: {{#time: xmF xmY}} → Рамадан 1442.

Функция #time может отображать числа в некоторых других системах счисления с помощью x-кодов (x_), включая: хинди (xn или xN), иврит (xh) и римские цифры (xr). Например, чтобы показать текущее время H: i: s римскими цифрами: {{#time: xrH: xri: xrs}} → XII: XX: XXXII. См. Другие примеры ниже: Коды формата времени .

Общие характеристики [ править ]

Функция парсера #time принимает дату и / или время (в григорианском календаре ) и форматирует их в соответствии с заданным синтаксисом. Можно указать объект даты / времени; по умолчанию используется значение волшебного слова, {{CURRENTTIMESTAMP}} то есть время последней визуализации страницы в HTML.

{{#time: format string }}

{{#time: format string | date/time object }}

{{#time: format string | date/time object | language code }}

Список допустимых кодов форматирования приведен в таблице ниже . Любой символ в строке форматирования, который не распознан, передается без изменений; это относится также к пробелам (они не нужны системе для интерпретации кодов). Есть также два способа экранирования символов в строке форматирования:

1. Обратная косая черта, за которой следует символ форматирования, интерпретируется как один буквальный символ.
2. Символы, заключенные в двойные кавычки, считаются буквальными символами, а кавычки удаляются.

Кроме того, орграф xxинтерпретируется как единственный литерал «x».

{{#time: Y-m-d }}→ 2021-04-25

{{#time: [[Y]] m d }}→ 2021 04 25

{{#time: [[Y (year)]] }}→ 2021 (21UTCpm вс, 25 апреля 2021 12:20:32 +0000)

{{#time: [[Y "(year)"]] }}→ 2021 (год)

{{#time: i's" }}→ 20'32 "

date/time objectМожет быть в любом формате , принятом в PHP StrToTime () функции. Принимаются как абсолютное (например, 20 December 2000), так и относительное (например, +20 hours) время.

{{#time: r|now}}→ Вс, 25 апр 2021 12:20:32 +0000

{{#time: r|+2 hours}}→ Вс, 25 апр 2021 14:20:32 +0000

{{#time: r|now + 2 hours}}→ Вс, 25 апр 2021 14:20:32 +0000

{{#time: r|20 December 2000}}→ Ср, 20 декабря 2000 00:00:00 +0000

{{#time: r|December 20, 2000}}→ Ср, 20 декабря 2000 00:00:00 +0000

{{#time: r|2000-12-20}}→ Ср, 20 декабря 2000 00:00:00 +0000

{{#time: r|2000 December 20}}→ Ошибка: неверное время.

Двухбуквенный код языка в ISO 639-1 позволяет отображать строку на выбранном языке.

{{#time:d F Y|1988-02-28|nl}}→ 28 февраля 1988 г.

{{#time:l|now|uk}}→ неділя

{{#time:d xg Y|20 June 2010|pl}}→ 20 сентября 2010 г.

Если вы рассчитали временную метку Unix, вы можете использовать ее при вычислении даты, предварительно отложив @символ.

{{#time: U | now }}→ 1619353232

{{#time: r|@1619353232}}→ Вс, 25 апр 2021 12:20:32 +0000

Диапазон допустимых входных данных: 1 января 0111 → 31 декабря 9999. Для лет с 100 по 110 результат непоследователен, Y и високосные годы подобны годам 100-110, r, D, l и U похожи на интерпретацию этих лет как 2000-2010. {{#time: d F Y | 29 Feb 0100 }}→ 01 марта 0100 (правильно, без високосного года), но {{#time: r | 29 Feb 0100 }}→ пн, 01 марта 0100 00:00:00 +0000 (неверно, даже если 100 интерпретируется как 2000, потому что это високосный год) {{#time: d F Y | 15 April 10000 }}→ Ошибка: недопустимое время. {{#time: r | 10000-4-15 }}→ Сб, 15 апр 2000 10:00:00 +0000 Номера годов 0-99 интерпретируются как 2000-2069 и 1970-1999, даже если они записаны с ведущими нулями: {{#time: d F Y | 1 Jan 0069 }}→ 01 января 0069 {{#time: d F Y | 1 Jan 0070 }}→ 01 января 0070 День недели предоставляется для 100–110 годов и с 1753 года, для года 111–1752 годовой вывод r показывает «Неизвестно», а l-вывод «<>». Как следствие, r-выпуск не принимается в качестве исходных данных для этих лет.

Могут быть указаны полные или частичные абсолютные даты; функция "заполнит" части даты, которые не указаны с использованием текущих значений:

{{#time: Y | January 1 }}→ 2021 г.

Предусмотрено множество вариантов.

Коды формата времени [ править ]

В следующей таблице объясняются 35 различных кодов для форматов даты / времени, а также коды месяцев на других языках и x-коды (x_) для преобразования в некоторые другие календари или системы счисления.

См. Также [ править ]

• Шаблон: время , текущая дата / время
• Шаблон: теперь показывает предложение с текущей датой / временем
• Шаблон: СЕГОДНЯ , показывает только текущую дату в типичной dmy форме
• Шаблон: Today , навигационный блок о ежедневном ток-шоу американского телевидения Today
• mw: Help: Extension: ParserFunctions # #time , страница документации разработчика
• Время Unix