Фильтр по периоду применяется только в том случае, если источником является Журнал.
При указании конкретных значений даты используйте формат ISO. YYYY-MM-DDThh:mm:ss
Формат:
Period (dateStart, dateFinish) - выбирает записи между указанными датами, включая dateStart и dateFinish.
Period (, dateFinish) - выбрать записи от начала до указанной dateFinish, включая датуFinish.
Period (dateStart,) - выбирает записи от указанного dateStart, включая dateStart, до конца.
Period (, Now) или Period (Now,) - выбирает до текущего момента времени или от текущего момента времени. Текущее время (Now) рассчитывается в соответствии с часовым поясом, установленным в настройках.
Period (standardPeriodName) - выбирает записи по «стандартному периоду».
Доступные стандартные периоды:
- ThisDay - Текущий день
- ThisWeek - Текущая неделя
- ThisMonth - Текущий месяц
- ThisQuarter - Текущий квартал
- ThisYear - Текущий месяц
- LastDay - Предыдущий день
- LastWeek - Предыдущая неделя
- LastMonth - Предыдущий месяц
- LastQuarter - Предыдущий квартал
- LastYear - Предыдущий год
- NextDay - Следующий день
- NextWeek - Следующая неделя
- NextMonth - Следующий месяц
- NextQuarter - Следующий квартал
- NextYear - Следующий год
- SlidingYear - Скользящий год (выбирает все записи от текущей даты минус 1 год)
- SlidingYearMinusMonth - Скользящий год минус месяц (выбирает все записи от текущей даты минус 1 год и минус текущий месяц)
Period (date, periodType) - выбирает записи для periodType, в которые входит данная дата.
Доступный период Тип:
- Day - день
- Month - месяц
- Quarter - квартал
- Year - год
Примеры:
Продажи |Period (ThisYear) | Select (Продукт, Количество) - выбирает все продажи текущего года.
Продажи | Period (ThisMonth) | Select (Продукт, Количество) - выбирает все продажи текущего месяца.
Продажи | Period( SlidingYear) | Select (Продукт, Количество) - выбирает все продажи от текущей даты минус 1 год;
Продажи | Period (, Now) | Select (Продукт, Количество) - выбирает все продажи до текущего момента времени.
Продажи |Period (2019-01-01T00: 00: 00, 2019-03-22T23: 59: 59) | Select (Продукт, Количество) - выбирает все продажи от начала дня 1 января 2019 года до конца дня 3 марта 2019 года.
Продажи | Period (2019-03-22, Month) | Select (Продукт, Количество) выбирает все продажи марта 2019 года.
Функции работы с датами
В фильтре по периоду доступны следующие функции работы с датами.
Функции, выполняющие добавление к дате соответствующих временных интервалов:
date.AddYears( count ) - добавляет к дате указанное количество лет;
date.AddMonths( count ) - добавляет к дате указанное количество месяцев;
date.AddDays( count ) - добавляет к дате указанное количество дней;
date.AddMinutes( count ) - добавляет к дате указанное количество минут;
date.AddSeconds( count ) - добавляет к дате указанное количество секунд.
Все функции, выполняющие добавление, могут принимать в качестве аргумента и отрицательные значения. В это случае выполняется вычитание соответствующих временных интервалов.
Функции, приводящие дату к началу периода:
date.BeginYear() - приводит дату к началу года;
date.EndYear() - приводит дату к концу года;
date.BeginMonth() - приводит дату к началу месяца;
date.EndMonth() - приводит дату к концу месяца;
date.BeginDay() - приводит дату к началу дня;
date.EndDay() - приводит дату к концу дня;
Функции, устанавливающие части даты:
date.SetYear( year ) , где year число - устанавливает год;
date.SetMonth( month ) , где month число - устанавливает месяц;
date.SetDay( day ) , где day число - устанавливает день;
date.SetHour( hour ) , где hour число - устанавливает час;
date.SetMinute( minute ) , где minute число - устанавливает час;
date.SetSecond( second ) , где second число - устанавливает секунды.
Перечисленные выше функции можно применять к дате последовательно в любом порядке, например:
Period( &dateStart.AddDays(-1).SetHour(11).SetMinute(7) , &dateFinish.AddDays(-1).SetHour(12).SetMinute(7) )