D5Plugin_FieldDateConvert — плагин для преобразования и распознавания различных форматов дат
Часто возникает необходимость преобразовать дату/время в удобный для вас формат. Для этого используется плагин D5Plugin_FieldDateConvert.
Особенности работы плагина
- Возможность обработки данных вроде “вчера в 16:15”.
- Возможность выбора из нескольких итоговых форматов преобразования.
- Возможность сравнения дат, если вам необходимо отсеять некоторый диапазон дат.
- Возможность ручного составления итогового результата.
- Возможность добавления случайных часов/минут/секунд.
- Можно подключать к любому количеству полей.
- Все параметры конфигурации необязательные, зачастую плагин может работать вообще без конфигурации.
- Плагин необходимо подключать к полю, в котором находится валидная (без лишних слов или символов) дата. При этом валидной она должна быть с включенными тегами, то есть лишнее необходимо удалить заменами.
Стоимость плагина составляет 10$. Ссылка на загрузку плагина предоставляется по запросу.
Импорт плагина в Datacol
Импорт плагинов в программу подробно описан в справке (доступной из интерфейса программы):
Подключение плагина к настройке
Плагин 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="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. Возвращается значение в соответствии с заданной конфигурацией.