Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page properties
hiddentrue
Status
Tech review

Status
titletodo

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged

UI Text Box
sizemedium
typeinfo

This function is used for searching JQL function returns projects with specific properties containing a date in format yyyy/MM/dd [hh:mm] or yyyy-MM-dd [hh:mm]. You can also use w (weeks) or d (days) to specify a date relative to the current date..

UI Text Box
typenote

Quote-marks " must be used.

Code Block
languagebash
titleSyntax
linenumberstrue
projectsWhereDateProperty(project_propertypropertyName, operator, date_literal) #Output: ProjectText list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
projects
project in projectsWhereDateProperty(
birthDay
"projectStart", ">", 
2012
"2020/01/01
")
this
This example returns a list of projects where
property 'birthDay' stores a date after '2012
the property called projectStart contains a date value greater than 2020/01/01i.e. text {projectStart=2020/05/05'} is present in the project's description.
Code Block
projects
linenumberstrue
project in projectsWhereDateProperty(
nextMeeting
"deadline", ">=", "-1w
")
This example returns a list of projects where
property 'nextMeeting' stores a date within the last seven days
a property called deadline exists with a date value greater than a week ago.
UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
project_propertypropertyName

Status
subtletrue
titletext

The name of a project property containing a text or string value.
operator

Status
subtletrue
titledata type

Comparison operator to be applied.

Expand
titlemore info...
  • "=" strict equal operator.
  • "!="  strict not an equal operator.
  • "~"  approximate equal operator (case insensitive and trims blanks).
  • "!~" approximate not equal operator (case insensitive and trims blanks).
  • "matches" The value of project property matches a regular expression.
  • "doesn't match" The value of project property doesn't match a regular expression.
  • ">, >=, <, <=" lexicographical order operators.

text

A valid comparison operator.

datedate_literal

Status
subtletrue
titletext

The date to be compared with the date stored in the project property. 

ui-text-box
typeinfo

The date must have a format of yyyy/MM/dd [hh:mm] or yyyy-MM-dd [hh:mm]

ui-expand
titleOutput

This function returns a

Status
subtletrue
titletext list
.

Include Page
DECADIS:_snip_limit_JQL_functions
DECADIS:_snip_limit_JQL_functions

Page properties
hiddentrue
Short description

Returns projects with specific properties containing a date

Output

Status
subtletrue
title

Project list

text list

Label
Page properties
hiddentrue

Status
Tech review

Status
colourYellow
titleReady for review

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged