WikiDer > Справка: функция времени - Википедия
![]() | Эта справочная страница является практическое руководство. В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не один из Политика или рекомендации Википедии, и может отражать разные уровни консенсус и проверка. |
В функция времени, или же #время, это MediaWiki функция парсера для отображения даты / времени в других форматах. Например ( обновлять):
- {{#time: j F Y}} показывает: 15 декабря 2020 г. универсальное глобальное время Дата
- {{#time: F j, Y}} показывает: 15 декабря 2020 года, текущая дата в формате mdy
- {{#time: Y-m-d}} показывает: 2020-12-15, текущий ISO 8601 Дата
- {{#time: H: i: s}} показывает: 02:19:23, текущее время суток
- {{#time: l}} показывает «Вторник» как текущий день недели
- {{#time: d a y D}} показывает "день Вт" как текущий 3-буквенный день
- {{#time: j. F Y | 7 мая 2013 | de}} шоу «7. Mai 2013» как дата на немецком языке
- {{#time: xij xiF xiY}} показывает «25 азар 1399» как текущая дата в Иранский календарь
Существует более 35 кодов формата даты (см. Ниже: Коды формата времени), чтобы переставить день-месяц-год или час-минута-секунда (например, «j» для дня, «H» для часа или el «l» для отображения дня недели). Другие буквы обрабатываются как буквальный текст или используют обратную косую черту, чтобы избежать формата (' d'
показывает 'd'). Параметр 2 может обозначать другую дату / время (в любом из нескольких типичных форматов), в то время как двухбуквенный языковой код может быть указан в качестве параметра 3 для перевода названия месяца на другой язык.
За пределами Григорианский календарь, функция #time также может преобразовывать дату в другую календари используя x-коды (x_): исламский (xm), Иранский (xi), иврит (xj), Тайский (хк), Minguo (xo), или Японский календарь (xt). Например, чтобы показать Исламская дата, как месяц и год: {{#time: xmF xmY}} → Раби аль-тани 1442.
Функция #time может отображать числа в некоторых других системах счисления с помощью x-кодов (x_), включая: хинди (xn или xN), иврит (xh), и римские цифры (xr). Например, чтобы показать текущее время H: i: s римскими цифрами: {{#time: xrH: xri: xrs}} → II: XIX: XXIII. Смотрите больше примеров ниже: Коды формата времени.
Общие особенности
Функция парсера #time принимает дату и / или время (в Григорианский календарь) и форматирует его в соответствии с заданным синтаксисом. Может быть указан объект даты / времени; по умолчанию это значение Волшебное слово {{CURRENTTIMESTAMP}} - то есть время последнего отображения страницы в HTML.
- {{#время: строка формата }}
- {{#время: строка формата | дата / время объект }}
- {{#время: строка формата | дата / время объект | код языка }}
Список допустимых кодов форматирования приведен в таблице. ниже. Любой символ в строке форматирования, который не распознан, передается без изменений; это относится также к пробелам (они не нужны системе для интерпретации кодов). Есть также два способа экранирования символов в строке форматирования:
- Обратная косая черта, за которой следует символ форматирования, интерпретируется как один буквальный символ.
- Символы, заключенные в двойные кавычки, считаются буквальными символами, а кавычки удаляются.
Кроме того, орграф хх интерпретируется как единственный литерал «x».
- {{#time: Y-m-d}} → 2020-12-15
- {{#time: [[Y]] м д}} → 2020 12 15
- {{#time: [[Г (год)]]}} → 2020 (20UTCamTue, 15 дек 2020 02:19:23 +0000)
- {{#time: [[Y "(год)"]]}} → 2020 (год)
- {{#время - это" }} → 19'23"
В дата / время объект может быть в любом формате, принятом PHP strtotime () функция. Оба абсолютных (например, 20 декабря 2000 г.) и относительный (например, +20 часов) раз принимаются.
- {{#time: r | сейчас}} → Вт, 15 дек 2020 02:19:23 +0000
- {{#time: r | +2 часа}} → Вт, 15 дек 2020 04:19:23 +0000
- {{#time: r | сейчас + 2 часа}} → Вт, 15 дек 2020 04:19:23 +0000
- {{#time: r | 20 декабря 2000}} → Ср, 20 декабря 2000 г., 00:00:00 +0000
- {{#time: r | 20 декабря 2000 г.}} → Ср, 20 декабря 2000 г., 00:00:00 +0000
- {{#time: r | 2000-12-20}} → Ср, 20 декабря 2000 г., 00:00:00 +0000
- {{#time: r | 20 декабря 2000 г.}} → Ошибка: неверное время.
Двухбуквенный код языка в ISO 639-1 позволяет отображать строку на выбранном языке.
- {{#time: d F Y | 1988-02-28 | nl}} → 28 февраля 1988 г.
- {{#time: l | сейчас | uk}} → вівторок
- {{#time: d xg Y | 20 июня 2010 г. | pl}} → 20 czerwca 2010
Если вы рассчитали временную метку Unix, вы можете использовать ее в расчетах даты, предварительно отложив @ символ.
- {{#time: U | сейчас же }} → 1607998763
- {{#time: r | @ 1607998763}} → Вт, 15 дек 2020 02:19:23 +0000
![]() | Диапазон допустимых входных данных: 1 января 0111 → 31 декабря 9999. Для лет с 100 по 110 результат непоследователен, Y и високосные годы подобны годам 100-110, r, D, l и U похожи на интерпретацию этих лет как 2000-2010. {{#time: d F Y | 29 февраля 0100}} → 01 марта 0100 (правильно, без високосного года), но Номера годов 0-99 интерпретируются как 2000-2069 и 1970-1999, даже если они записаны с ведущими нулями:
|
Могут быть указаны полные или частичные абсолютные даты; функция "заполнит" части даты, которые не указаны с помощью Текущий значения:
- {{#time: Y | 1 января }} → 2020
Предусмотрено множество вариантов.
Коды формата времени
В следующей таблице объясняются 35 различных кодов для форматов даты и времени, а также коды месяцев на других языках и x-коды (x_) для преобразования в некоторые другие. календари или системы счисления.
Код | Описание | Текущий выход (Очистить кеш этой страницы обновлять) |
---|---|---|
Год | ||
Y | 4-значный год. | 2020 |
у | 2-значный год. | 20 |
L | 1, если это високосный год, 0 - если нет. | 1 |
о ¹ | ISO-8601 год указанной недели. ² | 2020 ³ |
¹ Требуется PHP 5.1.0 и новее и рев: 45208. | ||
Месяц | ||
п | Индекс месяца, без нуля. | 12 |
м | Индекс месяца с нулями. | 12 |
M | Аббревиатура названия месяца на языке сайта. | Декабрь |
F | Полное название месяца на языке сайта. | Декабрь |
xg | Выведите полное название месяца в родительном падеже для языков сайта, которые различают родительный падеж и именительный падеж. | Для польского: (именительный падеж) {{#time: d F Y | 20 июня 2010 г. | pl}} → 20 червец 2010 (родительный падеж) {{#time: d xg Y | 20 июня 2010 г. | pl}} → 20 сентября 2010 г. |
Неделю | ||
W | Номер недели ISO 8601, дополненный нулями. | 51 |
День | ||
j | День месяца без нуля. | 15 |
d | День месяца с нулями. | 15 |
z | День года (1 января = 0) .¹ | 349 |
D | Аббревиатура дня недели. Редко интернационализируется. | Вт |
л | Полное название дня недели. Редко интернационализируется. | вторник |
N | ISO 8601 день недели (понедельник = 1, воскресенье = 7). | 2 |
ш | Номер дня недели (воскресенье = 0, суббота = 6). | 2 |
¹ Чтобы получить день года по ISO, добавьте 1. | ||
Час | ||
а | «am» утром (00:00:00 → 11:59:59), иначе «pm» (12:00:00 → 23:59:59). | являюсь |
А | Заглавная версия а над. | ЯВЛЯЮСЬ |
грамм | Час в 12-часовом формате без нуля. | 2 |
час | Час в 12-часовом формате с нулями. | 02 |
грамм | Час в 24-часовом формате без нуля. | 2 |
ЧАС | Час в 24-часовом формате с нулями. | 02 |
Минуты и секунды | ||
я | Минуты после часа с нулями. | 19 |
s | Секунды после минуты с нулями. | 23 |
U | Секунды с 1 января 1970 г., 00:00:00 GMT. | 1607998763 |
Часовой пояс (по состоянию на 1.22wmf2) | ||
е | Идентификатор часового пояса. | универсальное глобальное время |
я | Дата перехода на летнее время или нет. | 0 |
О | Разница во времени по Гринвичу (GMT) | +0000 |
п | Разница во времени по Гринвичу (GMT), с двоеточием | +00:00 |
Т | Аббревиатура часового пояса. | универсальное глобальное время |
Z | Смещение часового пояса в секундах. | 0 |
Разное | ||
т | Количество дней в текущем месяце. | 31 |
c | Дата в формате ISO 8601, эквивалентная Г-м-д "Т" H: i: s + 00: 00. | 2020-12-15T02: 19: 23 + 00: 00 |
р | RFC 5322 форматированная дата, эквивалентная D, j M Y H: i: s +0000, с названиями дня недели и месяца, не интернационализированными. | Вт, 15 дек 2020 02:19:23 +0000 |
Негрегорианские календари | ||
Исламский | ||
xmj | День месяца. | 29 |
xmF | Полное название месяца. | Раби аль-тани |
xmn | Индекс месяца. | 4 |
xmY | Полный год. | 1442 |
Иранский (Джалалы) | ||
xij | День месяца. | 25 |
xiF | Полное название месяца. | Азар |
Синь | Индекс месяца. | 9 |
xiY | Полный год. | 1399 |
xiy | 2-значный год. | 99 |
иврит | ||
xjj | День месяца. | 29 |
xjF | Полное название месяца. | Кислев |
xjt | Количество дней в месяце. | 29 |
xjx | Родительная форма названия месяца. | Кислев |
xjn | Номер месяца. | 3 |
xjY | Полный год. | 5781 |
Тайский солнечный | ||
xkY | Полный год. | 2563 |
Мингу / год чучхе | ||
xoY | Полный год. | 109 |
Японское ненго | ||
xtY | Полный год. | 令 和 2 |
Флаги | ||
xn | Отформатируйте следующий числовой код как необработанное число ASCII. | На языке хинди {{#time: H, xnH}} производит ०६, 06. |
xN | Нравиться xn, но как переключаемый флаг, который действует до конца строки или до следующего появления xN в строке. | |
xr | Отформатируйте следующее число как римскую цифру. Работает только для номеров до 10 000 (до 3000 в версии до MediaWiki 1.20). | {{#time: xrY}} → MMXX |
хх | Отформатируйте следующее число как цифру на иврите. | {{#time: xhY}} → ב'ך ' |
Смотрите также
- Шаблон: Время, текущая дата / время
- Шаблон: Сейчас, показывает предложение с текущей датой / временем
- Шаблон: СЕГОДНЯ, показывает только текущую дату в типовой dmy форме
- Шаблон: Сегодня, навигационный ящик о ежедневном ток-шоу американского телевидения Сегодня
- mw: Справка: Расширение: ParserFunctions # #time, страница документации разработчика
- Время Unix