JQL функции в JIRA, о которых вы могли не знать. Часть I: startOfMonth() и endOfMonth()

Встроенный в JIRA язык запросов JQL очень удобен для поиска запросов и создания различных фильтров. За все долгие годы своего существования этот язык развивался и расширялся. И если раньше его возможности ограничивались отбором запросов, используя лишь их атрибуты (как стандартные так и кастомные), то теперь появились способы фильтрации более «изысканные» и нестандартные, которые могут оказаться весьма полезными на практике.

Предлагаю рассмотреть в цикле статей несколько интересных кейсов и способов их решения с помощью функций, которые «не на слуху».

Итак, рассмотрим ситуацию, когда нужно Получить список запросов, созданных в прошлом месяце или Получить список запросов, у которых «дедлайн» (атрибут Due Date) наступает в следующем месяце

Можем воспользоваться функциями startOfMonth() и endOfMonth(). Первая возвращает — первый день текущего месяца, вторая — последний день. Но дополнительной «фишкой» этих функций является возможность принимать параметр, который позволяет смещать эти даты на требуемый период.
Например, первое число следующего месяца можно получить так startOfMonth(«+1M»), где
«+» — определяет направление смещения (его спутником является конечно же «-«)
«M» — указывает на то, что смещение будет происходить в месяцах (возможные значения y|M|w|d|h|m или иначе год|месяц|неделя|день|час|минута)
«1» — определяет величину смещения

Как видите — все просто

В итоге, JQL запросы будут выглядеть следующим образом:
Получить список запросов, созданных в прошлом месяце 

created < endofMonth("-1M") and created > startofMonth("-1M")

и
Получить список запросов, у которых «дедлайн» (атрибут Due Date) наступает в следующем месяце

duedate < endofMonth("+1M") and duedate > startofMonth("+1M")

 

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *