Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

This JQL function returns users by checking against their user properties that contain date or date-time values.

Syntax
usersWithDateTimeProperty(propertyName, operator, value) #Output: Text list
Examples
Parser expressionDescription
assignee in usersWithDateTimeProperty("day_off", "<", "2021/11/03")
This example returns all issues where the assignee's property day_off is before 2021/11/03.
reporter in usersWithDateTimeProperty("birthday", ">=", "1997/09/16 [11:30]")
This example returns all issues where the reporter's property birthday is after or on the same day as 1997/09/16 11:30.
assignee in usersWithDateTimeProperty("day_off", "<", "2020/08/15 [12:30]")
This example returns all issues where the assignee's property day_off is before 2020/08/15 12:30.
assignee in usersWithDateTimeProperty("day_off", "<", "2020/09/16 [12:30]")

This example returns all issues where the assignee's property day_off is before 2020/09/16 12:30.



Additional information

Parameters used in this function

ParameterInput (data type)Description
propertyName

TEXT

The name of a user property containing a date or date-time value.

The property has to be saved in one of the following format:

  • yyyy/MM/dd
  • yyyy/MM/dd [hh:mm]
operator

TEXT

A valid comparison operator. Allowed operators are:

OperatorDescription
=Property must be equal to the specified value.
!=Property must not be equal to the specified value.
<

Property must be lower than the specified value,

meaning that the date saved date in the property must be before the specified date.

>

Property must be greater than the specified value,

meaning that the date saved date in the property must be after the specified date.

<=

Property must be lower or equals to the specified value,

meaning that the date saved date in the property must be before or equals to the specified date.

>=

Property must be greater or equals to the specified value,

meaning that the date saved date in the property must be after or equals to the specified date.

value

TEXT

The value to compare with the property, the following formats are accepted:

  • yyyy/MM/dd [hh:mm]
  • yyyy/MM/dd


In case you use the format yyyy/MM/dd, the time part of the date will automatically be set to 00:00.

Output

This function returns a TEXT LIST

If you want to search for issues where a user as a specific text or numeric property value, have a look the the usersWithTextProperty or usersWithNumericProperty() function.

If you want to search for issues, checking only if a property is being set ignoring it's value, have a look the the usersWithProperty() function.

The result is not what you expected? The number of returned issues feels too low?

By default, the maximum number of issues that will be returned by the JQL subquery, and thus can be processed by the logical expression is 1000.

To ensure the performance of your entire Jira instance, we limit the execution of the JQL function in terms of issue count and execution time. Please refer to your admin if you need to change the configuration.