D5Plugin_FieldDateConvert — плагин для преобразования и распознавания различных форматов дат

Часто возникает необходимость преобразовать дату/время в удобный для вас формат. Для этого используется плагин D5Plugin_FieldDateConvert.

Особенности работы плагина

  • Возможность обработки данных вроде “вчера в 16:15”.
  • Возможность выбора из нескольких итоговых форматов преобразования.
  • Возможность сравнения дат, если вам необходимо отсеять некоторый диапазон дат.
  • Возможность ручного составления итогового результата.
  • Возможность добавления случайных часов/минут/секунд.
  • Можно подключать к любому количеству полей.
  • Все параметры конфигурации необязательные, зачастую плагин может работать вообще без конфигурации.
  • Плагин необходимо подключать к полю, в котором находится валидная (без лишних слов или символов) дата. При этом валидной она должна быть с включенными тегами, то есть лишнее необходимо удалить заменами.

Стоимость плагина составляет 10$. Ссылка на загрузку плагина предоставляется по запросу.

Импорт плагина в Datacol

Импорт плагинов в программу подробно описан в справке (доступной из интерфейса программы):

Импорт плагина D5Plugin_FieldDateConvert

Подключение плагина к настройке

Плагин D5Plugin_FieldDateConvert подключается в качестве плагина обработки поля:

Подключение плагина D5Plugin_FieldDateConvert

Конфигурация плагина D5Plugin_FieldDateConvert задается в в соответствующей настройке.

Конфигурация плагина D5Plugin_FieldDateConvert

Описание параметров конфигурации плагина:

  • today – значение, обозначающее сегодняшний день на некоторых сайтах. Например, плагин может корректно распознать дату вроде “сегодня в 16:15”. Значение по умолчанию “сегодня”. Необязательный параметр.
  • yesterday – значение, обозначающее вчерашний день на некоторый сайтах, функционал идентичен параметру today. Значение по умолчанию “вчера”. Необязательный параметр.
  • addrandom – параметр, позволяющий добавить случайные часы/минуты/секунды. Принимает значения h — для часов, m — для минут, s — для секунд. То есть, если вам необходимо добавить к дате случайное количество часов и минут — значение данного поля должно быть hm. Необязательный параметр.
  • max-date – значение максимальной даты. Если плагин распознает дату больше, чем заданную в данном параметре — вернет пустую строку. Таким образом можно отсеять ненужные даты. Принимает значения даты, например: “2015.02.16” (без кавычек). Необязательный параметр.
  • min-date – функционал аналогичный параметру max-date, но он отвечает за нижнюю планку дат. Необязательный параметр.
  • out – тип итоговой возвращаемой даты, может принимать значения:
    • date-time — результат “16.02.2015 17:46:00”;
    • long-date — результат “16 февраля 2015 г.”;
    • short-date — результат “16.02.2015”;
    • unix-stamp — результат “1424108760”;
    • При пустом значении, либо при отсутствии данного параметра возвращается значение типа short-date;
    • manual — при использовании данного значения итоговый результат будет рассчитываться исходя из формулы параметра manual-out.
  • manual-out – используется, если параметр out задан как manual. Значение — формула, которую можно настраивать любым удобным способом, при этом в формуле можно использовать спецсимволы:
    • YY — год;
    • MM — месяц;
    • DD — день;
    • HH — часы;
    • mm — минуты;
    • SS — секунды%
    • Например: формула “YY.MM.DD — HH:mm” вернет значение такого типа “2015.2.16 — 17:46”;
    • Данный параметр необязательный.

Пример строки конфигурации плагина:

<dc5par type="string" name="out">manual</dc5par>
<dc5par type="string" name="manual-out">YY.MM.DD - HH:mm</dc5par>
<dc5par type="string" name="min-date">2015.01.01</dc5par>
<dc5par type="string" name="addrandom">hm</dc5par>

1. Плагин распознает спец слова исходя из значений параметров today и yesterday.

2. Распознанные спец слова заменяются соответствующими значениями дат.

3. Происходит попытка распознать как дату итоговое значение строки.

4. При необходимости добавляются случайные часы/минуты/секунды.

5. При необходимости проводится сравнение с максимальной и минимальной датами, и если наша дата не попадает в диапазон — возвращается пустое поле.

6. Возвращается значение в соответствии с заданной конфигурацией.