docdate

Назначение

Находит документы, относящиеся к указанному диапазону дат. Для корректной работы функции необходимо предварительно указать колонку с датой документа в поле «Выбранная колонка с датой/временем» в настройках узла «Индекс».

Синтаксис

docdate(тип_ограничения,дата_1[,дата_2])

Аргументы

Опциональные аргументы тип_ограничения, дата_1 и дата_2 позволяют ограничить дату документа определенным диапазоном. Аргумент тип_ограничения может принимать одно из нижеперечисленных значений:

  • lt/less/<: дата документа должна быть меньше значения дата_1;

  • le/less or equal/<=: дата документа должна быть меньше или равной значению дата_1;

  • gt/greater/>: дата документа должна быть больше значения дата_1;

  • ge/greater or equal/>=: дата документа должна быть больше или равной значению дата_1;

  • eq/equal/=: дата документа должна быть равной значению дата_1;

  • ne/not equal/!=: дата документа не должна быть равной значению дата_1;

  • bt/between/(): дата документа должна принадлежать интервалу (дата_1, дата_2);

  • be/between or equal/[]: дата документа должна принадлежать интервалу [дата_1, дата_2];

  • lo/left-open/(]: дата документа должна принадлежать интервалу (дата_1, дата_2];

  • ro/right-open/[): дата документа должна принадлежать интервалу [дата_1, дата_2).

Если тип ограничения состоит из математических символов (>, (), !=, и т.д.), его необходимо заключить в кавычки (">", "()", "!=", и т.д.). Параметры дата_1 и дата_2 должны быть указаны в формате «мм/дд/гггг». При отсутствии аргументов функция находит все документы, для которых указана дата.

Возвращаемое значение

Документы, соответствующие запросу.

Примеры

docdate() находит документы, для которых указана дата;

not docdate() находит документы без даты;

docdate(less, "02/25/2002") = docdate(lt, "02/25/2002") = docdate("<", "02/25/2002") находит документы до 25 февраля 2002 г.;

docdate("02/25/2002") = docdate(eq, "02/25/2002") = docdate("=", "02/25/2002") находит документы от 25 февраля 2002 г.;

docdate(be, "02/25/2002", "05/25/2003") = docdate("[]", "02/25/2002", "05/25/2003") находит документы в диапазоне между 25 февраля 2002 г. и 25 февраля 2003 г.