Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
本文介绍如何通过创建、更改、解析或关闭日期列出工作项，以及如何对团队冲刺使用日期宏（例如 @Today）和迭代宏。 有关迭代路径基础知识和客户端/宏限制，请参阅 按区域或迭代路径进行查询。
Prerequisites
| Category | Requirements |
|---|---|
| 访问级别 | - 若要查看和运行共享查询：项目成员。 - 要添加并保存共享查询：至少具有基本访问权限。 |
| Permissions | 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。 |
Note
具有公共项目的 利益干系人 访问权限的用户对查询功能具有完全访问权限，就像具有 基本 访问权限的用户一样。 有关详细信息，请参阅利益干系人访问快速参考。
| Category | Requirements |
|---|---|
| 访问级别 | - 若要查看和运行共享查询：项目成员。 - 要添加并保存共享查询：至少具有基本访问权限。 |
| Permissions | 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。 |
支持的运算符和日期宏
在查询编辑器中，对 DateTime 和迭代路径字段使用以下运算符和宏。
- DateTime 运算符：
= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever - 日期宏：
@StartOfDay、、@StartOfWeek@StartOfMonth、@StartOfYear、@Today
可以将+/- n与这些宏（例如，@Today - 7）组合使用。 - 迭代宏：
@CurrentIteration和@CurrentIteration +/- n（请参阅以下说明和链接，了解客户端限制和团队参数行为）。
Note
迭代页详细介绍了迭代宏和客户端限制： 按区域或迭代路径进行查询。 如果需要在非 Web 客户端中或通过 Web UI 外部的 REST/WIQL 运行查询，请在环境中验证宏支持，并考虑将宏扩展到显式路径。
快速日期示例（常见查询）
在过去 30 天内创建的项：
在特定日期修改的项目：
今天解决的项目：
在指定时间段内关闭的项：
关闭日期为 null（未关闭）：
状态在上周更改的项目：
使用@CurrentIteration宏命令（简短指南）
使用 @CurrentIteration 来定位团队的当前冲刺，并使用 @CurrentIteration +/- n 来创建冲刺的滑动窗口（例如：最后两个冲刺、当前冲刺和接下来的两个冲刺）。 要点：
-
@CurrentIteration返回被分配到当前冲刺中的项目（根据运行查询时所用的团队上下文）。 -
@CurrentIteration +/- n将迭代的时间窗口调整 n 个位置；适用于趋势或延续分析。 - 由于宏行为和客户端支持有所不同，请 按区域或迭代路径查询查询 ，了解有关团队参数的详细信息、哪些客户端评估宏，以及保存查询时宏的存储/扩展方式。
示例图像（Web 门户查询编辑器）：
Tip
如果未 @CurrentIteration 返回预期结果，请确认团队选择的迭代和团队设置中的迭代日期范围。
日期宏：一天/一周/一月/一年开始
起始宏有助于生成一致的相对日期范围：
-
@StartOfDay、@StartOfWeek、@StartOfMonth、@StartOfYear——使用这些宏与+/- n配合，生成范围，例如“自本周开始”或“过去3个月”。 - 这些宏由 Web 门户 UI 评估;它们在非 Web 方案中的行为可能有所不同 - 在目标客户端中进行测试。
示例查询：
何时直接使用 WIQL
在以下情况下使用 WIQL：
- 需要像
WAS EVER这样的高级运算符来进行迭代路径更改。 - 查询编辑器阻止或将子句标记为不受支持（例如，某些
Was Ever用法）。 WIQL 编辑器扩展允许你创作这些查询并保存这些查询。
有关示例，请参阅 工作项查询语言（WIQL）语法 和 WIQL 编辑器市场扩展。
相关内容
REST API
要以编程方式与查询交互，请参阅以下 REST API 资源之一：