此页面介绍用于高级搜索的函数的信息。

JQL 中的函数显示为一个单词，后跟括号，其中可能包含一个或多个显式值或 JIRA 字段。在子句中，函数之前是一个运算符，而运算符之前是一个字段。函数对括号中的特定 JIRA 数据或函数内容执行计算，以使函数仅返回真值结果，进而使得调用该函数的子句也返回真值的结果。

请注意，除非在搜索查询中指定，否则 JQL 搜索不会在结果中返回空白字段。要在搜索未指派给当前用户的事务时包含空白字段（例如未指派的事务），您需要输入 (assignee != currentUser() OR assignee is EMPTY)，以将未指派的事务包含在结果列表中。

approved()

只有在已安装 JIRA Service Desk 且已获得许可时适用。

搜索需要批准且最终决定为获批的事务。

语法
approved()
支持的字段类型为“Approval”的自定义字段
支持的运算符=
不支持的运算符~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
示例
  • 查找已获批的所有事务：
    approval = approved()

返回页首

approver()

只有在已安装 JIRA Service Desk 且已获得许可时适用。

搜索需要或过去需要列出的用户批准的事务。这会使用 OR 运算符，并且您必须指定用户名。

语法
approver(user,user)
支持的字段类型为“Approval”的自定义字段
支持的运算符=
不支持的运算符~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
示例
  • 查找需要或过去需要 John Smith 批准的事务：
    approval = approver(jsmith)
  • 查找需要或过去需要 John Smith 或 Sarah Khan 批准的事务：
    approval = approver(jsmith,skhan)

返回页首

cascadeOption()

搜索与“级联选择”自定义字段的选定值匹配的事务。

parentOption 参数与级联选择字段中的第一层选项匹配。childOption 参数与级联选择字段中的第二层选项匹配，为可选参数。 

关键词 "none" 可用于搜索任一选项或两个选项都没有值的事务。

语法
cascadeOption(parentOption)
cascadeOption(parentOption,childOption)
支持的字段类型为“Cascading Select”的自定义字段
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例
  • 查找自定义字段（“Location”）的第一层值为“USA”，且第二层值为“New York”的事务：
    location in cascadeOption("USA","New York")
  • 查找自定义字段（“Location”）的第一层值为“USA”，且第二层为任意值（或没有值）的事务：
    location in cascadeOption( "USA" )
  • 查找自定义字段（“Location”）的第一层值为“USA”，且第二层没有值的事务：
    location in cascadeOption( "USA" ,none)
  • 查找自定义字段（“Location”）的第一层没有值，且第二层也没有值的事务：
    location in cascadeOption(none)
  • 查找自定义字段（“Referrer”）的第一层值为“none”，且第二层值也为“none”的事务：
    referrer in cascadeOption( "\"none\"" , "\"none\"" )

  • 查找自定义字段（“Referrer”）的第一层值为“none”，且第二层没有值的事务：
    referrer in cascadeOption( "\"none\"" ,none)

返回页首

closedSprints()

搜索指派给已完成的 Sprint 的事务。请注意，某事务可能同时属于已完成的 Sprint 和未完成的 Sprint。另请参见 openSprints()。

语法
closedSprints()
支持的字段Sprint
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找指派给已完成的 Sprint 的所有事务：
    sprint in closedSprints()

返回页首

componentsLeadByUser()

查找由特定用户负责的组件中的事务。您可以有选择性地指定用户，或者如果省略用户，则将使用当前用户（即您）。请注意，如果您未登录 JIRA，则必须指定一个用户。

语法
componentsLeadByUser()
componentsLeadByUser(username)
支持的字段Component
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找由您负责的组件中的活动事务：
    component in componentsLeadByUser() AND status = Open

  • 查找由 Bill 负责的组件中的活动事务：
    component in componentsLeadByUser(bill) AND status = Open

返回页首

currentLogin()

基于当前用户的会话开始时间执行搜索。另请参见 lastLogin。

语法
currentLogin()
支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN
示例

  • 查找在我的当前会话期间创建的事务：
    created > currentLogin()

返回页首

currentUser()

基于当前已登录的用户执行搜索。请注意，此函数只能由已登录的用户使用。因此，如果您要创建一个希望由匿名用户使用的已保存的过滤器，请勿使用此函数。

语法
currentUser()
支持的字段Assignee、Reporter、Voter、Watcher、类型为“User”的自定义字段
支持的运算符= , != 
不支持的运算符~ , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找指派给我的事务：
    assignee = currentUser()

  • 查找由我报告但未指派给我的事务：

    reporter = currentUser() AND (assignee != currentUser() OR assignee is EMPTY)

返回页首

earliestUnreleasedVersion()

基于指定项目的最早未发布版本（即将要发布的下一个版本）执行搜索。另请参见 unreleasedVersions。注意，“最早”由指派给版本的顺序（而不是实际的版本到期日期）确定。

语法
earliestUnreleasedVersion(project)
支持的字段AffectedVersion、FixVersion、类型为“Version”的自定义字段
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找其“FixVersion”是 ABC 项目的最早未发布版本的事务：
    fixVersion = earliestUnreleasedVersion(ABC)

  • 查找与 ABC 项目的最早未发布版本相关的事务：
    affectedVersion = earliestUnreleasedVersion(ABC) or fixVersion = earliestUnreleasedVersion(ABC)

返回页首

endOfDay()

基于当天的结束时间执行搜索。另请参见 endOfWeek、endOfMonth 和 endOfYear；以及 startOfDay、startOfWeek、startOfMonth 和 startOfYear。

语法
endOfDay()
endOfDay("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，endOfDay("+1") 与 endOfDay("+1d") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找今天结束之前到期的事务：
    due < endOfDay()

  • 查找明天结束之前到期的事务：
    due < endOfDay("+1")

返回页首

endOfMonth()

基于当月的结束时间执行搜索。另请参见 endOfDay、endOfWeek 和 endOfYear；以及 startOfDay、startOfWeek、startOfMonth 和 startOfYear。

语法
endOfMonth()
endOfMonth("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，endOfMonth("+1") 与 endOfMonth("+1M") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找本月结束之前到期的事务：
    due < endOfMonth()

  • 查找下个月结束之前到期的事务：
    due < endOfMonth("+1")

  • 查找下个月 15 日结束之前到期的事务：
    due < endOfMonth("+15d")

返回页首

endOfWeek()

基于本周的结束时间执行搜索。另请参见 endOfDay、endOfMonth 和 endOfYear；以及 startOfDay、startOfWeek、startOfMonth 和 startOfYear。

对于 endOfWeek() 函数，结果取决于您的区域设置。例如，在欧洲，一周的第一天通常被认为是周一，而在美国，它被认为是周日。

语法
endOfWeek()
endOfWeek("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，endOfWeek("+1") 与 endOfWeek("+1w") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找本周结束之前到期的事务：
    due < endOfWeek()

  • 查找下周结束之前到期的事务：
    due < endOfWeek("+1")

返回页首

endOfYear()

基于今年的结束时间执行搜索。另请参见 startOfDay、startOfWeek 和 startOfMonth；以及 endOfDay、endOfWeek、endOfMonth 和 endOfYear。

语法
endOfYear()
endOfYear("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，endOfYear("+1") 与 endOfYear("+1y") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找今年结束之前到期的事务：
    due < endOfYear()

  • 查找明年结束之前到期的事务：
    due < endOfYear("+3M")

返回页首

issueHistory()

查找您最近查看的事务，即“Issues”下拉菜单的“Recent Issues”部分中的事务。

注意：

  • issueHistory() 最多返回 50 个事务，而“Recent Issues”下拉列表只返回 5 个。
  • 如果您没有登录 JIRA，则系统仅包括当前浏览器会话中的事务。
语法
issueHistory()
支持的字段Issue
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找我最近查看过且已指派给我的事务：
    issue in issueHistory() AND assignee = currentUser()

返回页首

issuesWithRemoteLinksByGlobalId()

基于与具有任意指定全局 ID 的远程链接关联的事务执行搜索。

注意：

  • 此函数接受 1 到 100 的全局 ID。指定 0 或大于 100 的全局 ID 将导致错误。
语法
issuesWithRemoteLinksByGlobalId()
支持的字段Issue
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找链接到具有全局 ID“abc”的远程链接的事务：
    issue in issuesWithRemoteLinksByGlobalId(abc)

  • 查找链接到具有全局 ID“abc”或“def”的远程链接的事务：
    issue in issuesWithRemoteLinksByGlobalId(abc, def)

返回页首

lastLogin()

基于当前用户上一会话的开始时间执行搜索。另请参见 currentLogin。

语法
lastLogin()
支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN
示例

  • 查找在我的上一会话期间创建的事务：
    created > lastLogin()

返回页首

latestReleasedVersion()

基于指定项目的最晚已发布版本（即已发布的最新版本）执行搜索。另请参见 releasedVersions()。注意，“最晚”由指派给版本的顺序（而不是实际的版本到期日期）确定。

语法
latestReleasedVersion(project)
支持的字段AffectedVersion、FixVersion、类型为“Version”的自定义字段
支持的运算符= , !=
不支持的运算符

~ , !~ , > , >= , < , <=

IS , IS NOT , IN , NOT IN, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED

示例

  • 查找其“FixVersion”是 ABC 项目的最晚已发布版本的事务：
    fixVersion = latestReleasedVersion(ABC)

  • 查找与 ABC 项目的最晚已发布版本相关的事务：
    affectedVersion = latestReleasedVersion(ABC) or fixVersion = latestReleasedVersion(ABC)

返回页首

linkedIssues()

基于链接到指定事务的事务执行搜索。您可以有选择性地将搜索限制为特定类型的链接。请注意，“LinkType”区分大小写。

语法
linkedIssues(issueKey)
linkedIssues(issueKey,linkType)
支持的字段Issue
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找链接到特定事务的事务：
    issue in linkedIssues(ABC-123)

  • 查找通过特定链接类型链接到特定事务的事务：
    issue in linkedIssues(ABC-123,"is duplicated by")

返回页首

membersOf()

基于特定群组的成员执行搜索。

语法
membersOf(Group)
支持的字段Assignee、Reporter、Voter、Watcher、类型为“User”的自定义字段
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找经办人是“jira-administrators”群组成员的事务：
    assignee in membersOf("jira-administrators")

  • 搜索多个群组和特定用户：
    reporter in membersOf("jira-administators") or reporter in membersOf("jira-core-users") or reporter=jsmith

  • 搜索特定群组，但排除特定成员或多个成员：
    assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")

  • 排除特定群组的成员：
    assignee not in membersOf(QA)

返回页首

myApproval()

只有在已安装 JIRA Service Desk 且已获得许可时适用。

搜索需要当前用户批准的事务。

语法
myApproval()
支持的字段类型为“Approval”的自定义字段
支持的运算符=
不支持的运算符~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
示例
  • 查找需要我批准的所有事务
    approval = myApproval()

返回页首

myPending()

只有在已安装 JIRA Service Desk 且已获得许可时适用。

搜索需要当前用户批准的事务：

语法
approved()
支持的字段类型为“Approval”的自定义字段
支持的运算符=
不支持的运算符~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
示例
  • 查找需要我批准的所有事务
    approval = myPending()

返回页首

now()

基于当前时间执行搜索。

语法
now()
支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN
示例

  • 查找已到期的事务：
    duedate < now() and status not in (closed, resolved)

返回页首

openSprints()

搜索指派给尚未完成的 Sprint 的事务。请注意，某事务可能同时属于已完成的 Sprint 和未完成的 Sprint。另请参见 closedSprints()。

语法
openSprints()
支持的字段Sprint
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找指派给尚未完成的 Sprint 的所有事务：
    sprint in openSprints()

返回页首

pending()

只有在已安装 JIRA Service Desk 且已获得许可时适用。

搜索需要批准的事务。

语法
pending()
支持的字段类型为“Approval”的自定义字段
支持的运算符=
不支持的运算符~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
示例
  • 找出所有需要批准的事务：
    approval = pending()

返回页首

pendingBy()

只有在已安装 JIRA Service Desk 且已获得许可时适用。

搜索需要列出的用户批准的事务。这会使用 OR 运算符，并且您必须指定用户名。

语法
pendingBy(user1,user2)
支持的字段类型为“Approval”的自定义字段
支持的运算符=
不支持的运算符~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
示例
  • 找出需要 John Smith 批准的事务：
    approval = pending(jsmith)
  • 查找需要 John Smith 或 Sarah Khan 批准的事务：
    approval = pending(jsmith,skhan)

返回页首

projectsLeadByUser()

查找由特定用户负责的项目中的事务。您可以有选择性地指定用户，或者如果省略用户，则将使用当前用户。请注意，如果您未登录 JIRA，则必须指定一个用户。

语法
projectsLeadByUser()
projectsLeadByUser(username)
支持的字段Project
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找由您负责的项目中的活动事务：
    project in projectsLeadByUser() AND status = Open

  • 查找由 Bill 负责的项目中的活动事务：
    project in projectsLeadByUser(bill) AND status = Open

返回页首

projectsWhereUserHasPermission()

查找您具有特定权限的项目中的事务。请注意，此函数在项目级别执行。这意味着，如果已向某项目中事务的报告人授予了某权限（例如“Edit Issues”），那么，您可能会发现，对于某些返回的事务，您不是报告人，因此没有指定的权限。 另请注意，此函数仅在您登录 JIRA 后可用。

语法
projectsWhereUserHasPermission(permission)

对于 permission 参数，您可以指定...中所述的任意权限。

支持的字段Project
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找您具有“Resolve Issues”权限的项目中的活动事务：
    project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open

返回页首

projectsWhereUserHasRole()

查找您具有特定角色的项目中的事务。请注意，此函数仅在您登录 JIRA 后可用。

语法
projectsWhereUserHasRole(rolename)
支持的字段Project
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找您具有“Developers”角色的项目中的活动事务：
    project in projectsWhereUserHasRole("Developers") AND status = Open

返回页首

releasedVersions()

基于指定项目的已发布版本（即 JIRA 管理员已发布的版本）执行搜索。您也可以通过省略 project 参数，基于所有项目的已发布版本执行搜索。另请参见 latestReleasedVersion()。

语法
releasedVersions()
releasedVersions(project)
支持的字段AffectedVersion、FixVersion、类型为“Version”的自定义字段
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找其“FixVersion”是 ABC 项目的已发布版本的事务：
    fixVersion in releasedVersions(ABC)

  • 查找与 ABC 项目的已发布版本相关的事务：
    (affectedVersion in releasedVersions(ABC)) or (fixVersion in releasedVersions(ABC))

返回页首

standardIssueTypes()

基于“标准”事务类型执行搜索，即搜索不是子任务的事务。另请参见 subtaskIssueTypes()。

语法
standardIssueTypes()
支持的字段Type
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找不是子任务的事务（即“Issue Type”为标准事务类型，而不是子任务事务类型）：
    issuetype in standardIssueTypes()

返回页首

startOfDay()

基于当天的开始时间执行搜索。另请参见 startOfWeek、startOfMonth 和 startOfYear；以及 endOfDay、endOfWeek、endOfMonth 和 endOfYear。

语法
startOfDay()
startOfDay("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，startOfDay("+1") 与 startOfDay("+1d") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找自今天开始后创建的新事务：
    created > startOfDay()

  • 查找自昨天开始后创建的新事务：
    created > startOfDay("-1")

  • 查找在过去三天内创建的新事务：
    created > startOfDay("-3d")

返回页首

startOfMonth()

基于当月的开始时间执行搜索。另请参见 startOfDay、startOfWeek 和 startOfYear；以及 endOfDay、endOfWeek、endOfMonth 和 endOfYear。

语法
startOfMonth()
startOfMonth("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，startOfMonth("+1") 与 startOfMonth("+1M") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找自本月开始后创建的新事务：
    created > startOfMonth()

  • 查找自上个月开始后创建的新事务：
    created > startOfMonth("-1")

  • 查找自本月 15 日开始后创建的新事务：
    created > startOfMonth("+14d")

返回页首

startOfWeek()

基于本周的开始时间执行搜索。另请参见 startOfDay、startOfMonth 和 startOfYear；以及 endOfDay、endOfWeek、endOfMonth 和 endOfYear。对于 startOfWeek() 函数，结果取决于您的区域设置。例如，在欧洲，一周的第一天通常被认为是周一，而在美国，它被认为是周日。

语法
startOfWeek()
startOfWeek("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，startOfWeek("+1") 与 startOfWeek("+1w") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找自本周开始后创建的新事务：
    created > startOfWeek()

  • 查找自上周开始后创建的新事务：
    created > startOfWeek("-1")

返回页首

startOfYear()

基于本年的开始时间执行搜索。另请参见 startOfDay、startOfWeek 和 startOfMonth，以及 endOfDay、endOfWeek、endOfMonth 和 endOfYear。

语法
startOfYear()
startOfYear("inc")

其中，inc  是 (+/-)nn(y|M|w|d|h|m) 的可选增量。如果省略时间单位限定符，则默认为函数的自然周期，例如，endOfYear("+1") 与 endOfYear("+1y") 相同。如果省略加号/减号 (+/-)，则假定使用加号。

支持的字段Created、Due、Resolved、Updated、类型为“Date/Time”的自定义字段
支持的运算符= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* 仅用于谓词
不支持的运算符~ , !~ IS , IS NOT , IN , NOT IN 
示例

  • 查找自本年开始后创建的新事务：
    created > startOfYear()

  • 查找自去年开始后创建的新事务：
    created > startOfYear("-1")

返回页首

subtaskIssueTypes()

基于子任务事务执行搜索。另请参见 standardIssueTypes()。

语法
subtaskIssueTypes()
支持的字段Type
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找是子任务的事务（即“Issue Type”为子任务事务类型）：
    issuetype in subtaskIssueTypes()

返回页首

unreleasedVersions()

基于指定项目的未发布版本（即 JIRA 管理员尚未发布的版本）执行搜索。您也可以通过省略 project 参数，基于所有项目的未发布版本执行搜索。另请参见 earliestUnreleasedVersion()。

语法
unreleasedVersions()
unreleasedVersions(project)
支持的字段AffectedVersion、FixVersion、类型为“Version”的自定义字段
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找其“FixVersion”是 ABC 项目的未发布版本的事务：
    fixVersion in unreleasedVersions(ABC)

  • 查找与 ABC 项目的未发布版本相关的事务：
    affectedVersion in unreleasedVersions(ABC)

返回页首

votedIssues()

基于您已投票赞成的事务执行搜索。另请参见 Voter 字段。请注意，此函数只能由已登录的用户使用。

语法
votedIssues()
支持的字段Issue
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找您已投票赞成的事务：
    issue in votedIssues()

返回页首

watchedIssues()

基于您正在关注的事务执行搜索。另请参见 Watcher 字段。请注意，此函数只能由已登录的用户使用。

语法
watchedIssues()
支持的字段Issue
支持的运算符IN , NOT IN
不支持的运算符= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
示例

  • 查找您正在关注的事务：
    issue in watchedIssues()

返回页首

 

函数列表：

 

  • 无标签