Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
本文說明如何依建立、變更、解決或關閉日期列出工作專案，以及如何使用日期宏 （例如 @Today） 和小組短期衝刺的反覆專案宏。 如需反覆執行路徑基本原理和客戶端/巨集限制條件，請參閱 依區域或反覆執行路徑查詢。
Prerequisites
| Category | Requirements |
|---|---|
| 存取層級 | - 若要檢視及執行共享查詢：專案成員。 - 若要新增和儲存共用查詢：至少需有 基本 權限。 |
| Permissions | 必須將您要新增查詢的資料夾的 權限設定為 允許。 根據預設，參與者 群組沒有此許可權。 |
Note
具有 項目關係人 公用專案存取權的使用者，可以完整存取查詢功能，就像具有 Basic 存取權的使用者一樣。 如需詳細資訊，請參閱 項目關係人存取快速參考。
| Category | Requirements |
|---|---|
| 存取層級 | - 若要檢視及執行共享查詢：專案成員。 - 若要新增和儲存共用查詢：至少需要 基本 存取。 |
| Permissions | 必須將您要新增查詢的資料夾的 權限設定為 允許。 根據預設，參與者 群組沒有此許可權。 |
支援的運算子和日期巨集
針對查詢編輯器中的 DateTime 和 Iteration Path 欄位使用下列運算子和巨集。
- 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 個單位；對於趨勢或結轉分析非常有用。 - 因為宏的行為和客戶端支援會有所不同，因此請參閱 依區域或反覆項目路徑查詢 以了解小組參數、哪些客戶端會評估宏，以及在儲存查詢時宏如何被儲存/展開的詳細資訊。
範例影像 （入口網站查詢編輯器）：
Tip
如果 @CurrentIteration 未傳回預期結果，請確認團隊設定中選擇的迭代及其日期範圍。
日期巨集：日/週/月/年的開始
啟動巨集有助於建立一致的相對日期範圍：
-
@StartOfDay，@StartOfWeek，@StartOfMonth，@StartOfYear— 使用這些巨集+/- n來建立範圍，例如「自本週開始」或「過去 3 個月」。 - 這些宏會由入口網站 UI 評估;它們在非 Web 案例中的行為可能會有所不同，請在您的目標用戶端中進行測試。
範例查詢：
此螢幕快照顯示查詢編輯器中預定在未來三個月內完成的功能子句。
直接使用 WIQL 的時機
在下列情況下使用 WIQL：
- 您需要使用進階運算符，例如
WAS EVER，以便進行疊代路徑的變更。 - 查詢編輯器會封鎖子句或將子句標示為不支援 （例如，某些
Was Ever用途）。 WIQL 編輯器延伸模組可讓您撰寫這些查詢並儲存它們。
如需範例，請參閱 工作專案查詢語言 （WIQL） 語法 和 WIQL 編輯器市集延伸模組。
相關內容
REST API
若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：