Позволяет конвертировать дату и время из одного формата в другой формат.
| datetime |
Строка, содержащая дату и/или время. Если не задать ключ (или оставить пустым), то его значение равно текущим дате и времени. |
| format_in |
Маска разбора входной строки. Если не задать ключ (или оставить пустым), его значение "DD.MM.YYYY hh:mm:ss". |
| format_out |
Маска формирования выходной строки. Если не задать ключ (или оставить его пустым), его значение "DD.MM.YYYY". |
| design |
Строка, идентификатор дизайна (id секции datettimedesign) сервиса, который будет использоваться при выводе. Разные дизайны применяются (в основном) для переключения между различными языками в рамках одного проекта или для того, чтобы не переводить каждый раз стандартные сообщения при переходе от проекта к проекту. По умолчанию ключ имеет значение "russian". |
| delta_days |
Число, позволяющее сдвинуть заданную на входе дату, задается в днях. Может быть как целым, так и дробным (0.5 дней = 12 часов, например). Положительные значения прибавляют дни к дате, отрицательные - вычитают. |
Обычно применяется для оформления стандартного представления даты и времени, используемого Twilight CMS по умолчанию (hh:mm:ss DD.MM.YYYY) в более подходящий для отображения на страницах.
В масках допустимы следующие подстановки (регистрозависимы):
DD – день
MM – месяц
YY - двузначный год
YYYY - четырехзначный год
MONTH - имя месяца: январь, февраль и т.д.
MONTH_SHORT - имя месяца в короткой форме: янв, фев и т.д.
MONTH_GENITIVE - имя месяца в родительном падеже: января, февраля и.т.д.
hh – часы
mm – минуты
ss - секунды
WEEKDAY - день недели: понедельник, вторник и т.д.
WEEKDAY_SHORT - короткое имя дня недели: пн, вт, ср и т.д.
Если год на входе задан в двузначной форме, а на выходе нужен в четырехзначной, сервис интерпретирует значения 00..49 как 2000..2049, а 50..99 как 1950..1999 годы.
Дизайны сервиса должны находиться в файле Templates/datetime_design.xml, пример которого можно найти на http://www.twl.ru/tsdn/macros_templates/datetime_design_xml. В этом файле задаются имена дней недели, месяцев и сообщения об ошибках.
Внимание: в любом случае для корректной работы сервиса необходимо задать и день, и месяц и год (в любом приемлемом формате). В случае, если нет, например, дня - нужно добавить какое-то число из диапазона 1..31 к входной строке вручную.
