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 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.

Quote-marks " must be used.


Code Block
languagebash
titleSyntax
linenumberstrue
projectsWhereDateProperty(project_property, operator, date_literal) #Output: Project list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
projects in projectsWhereDateProperty( birthDay, ">", 2012/01/01 )


this example returns a list of projects where property 'birthDay' stores a date after '2012/01/01'.


Code Block
projects in projectsWhereDateProperty( nextMeeting, ">=", -1w )


This example returns a list of projects where property 'nextMeeting' stores a date within the last seven days.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
project_property

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.


date_literal

Status
subtletrue
titletext

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



UI Expand
titleOutput

This function returns a

Status
subtletrue
titleProject list