FetchXML 條件運算子值

在條件元素的屬性中使用 FetchXML 條件運算子 operator 值，指定在篩選列時如何評估條件。 此參考文獻列出每個運算元、其支援的資料型態及範例。 若要瞭解如何使用這些值，請參閱 使用 FetchXml 篩選資料列。

Operator Description 數據類型
上面 傳回參考記錄階層祖先行中的所有記錄。 階層式
開始-以 字串出現在另一個字串的開頭。 字串
between 值介於兩個值之間。 Number
日期時間
包含值 選擇值是指定的值之一。 選擇
結束 字串以另一個字串結尾。 字串
eq 會比較這些值是否相等。 選擇
日期時間
階層式
Number
Owner
字串
唯一識別碼
eq-businessid 此值等於指定的企業 ID。 唯一識別碼
eq-or-以上 傳回參考的記錄，以及階層中其上方的所有記錄。 階層式
eq-or-下 傳回參考的記錄，以及階層中其下方的所有子記錄。 階層式
eq-userid 此值等於指定的使用者 ID。 唯一識別碼
eq-user語言 此值等於使用者的語言。 Number
eq-user或user階層 使用階層式安全性模型時，等於目前使用者或其報告階層。 階層式
eq-useroruserhierarchyandteams 使用階層式安全性模型時，等於目前使用者及其小組或其報告階層及其小組。 階層式
eq-user或userteams 記錄由使用者所屬的使用者或小組所擁有。 Owner
eq-user團隊 記錄由使用者所屬的使用者或小組所擁有。 Owner
ge 值大於或等於比較值。 Number
日期時間
字串
gt 值大於比較值。 Number
日期時間
字串
在 該值存在於值清單中。 選擇
Number
Owner
字串
唯一識別碼
會計期內 該值在指定的會計期間內。 日期時間
會計期間和年度內 該值在指定的會計期間和年度內。 日期時間
會計年度內 值在指定的年份內。 日期時間
in-or-會計期間和年度後 該值在指定的會計期間和年度內或之後。 日期時間
in-or-會計期間和年度之前 該值在指定的會計期間和年份內或之前。 日期時間
上一個會計期間 該值在上一個會計期間內。 日期時間
上一會計年度 該值在上一個會計年度內。 日期時間
上個月 值在上個月內，包括上個月的第一天和上個月的最後一天。 日期時間
過去 7 天 該值是過去 7 天內（包括今天）。 日期時間
上週 該值是前一周內的，包括星期日到星期六。 日期時間
過去 X 天 此值在先前指定的天數內。 日期時間
最後 x 會計期間 此值在先前指定的會計期間數內。 日期時間
過去 x 會計年度 此值在先前指定的會計期間數內。 日期時間
最後 X 小時 此值在先前指定的小時數內。 日期時間
過去 X 個月 此值在先前指定的月數內。 日期時間
過去 X 週 此值在先前指定的週數內。 日期時間
過去 X 年 該值在先前指定的年數內。 日期時間
去年 值在前一年內。 日期時間
le 該值小於或等於比較值。 Number
日期時間
字串
喜歡 字串會比對指定的型樣。 字串
lt 該值小於比較值。 Number
日期時間
字串
ne 這兩個值不相等。 選擇
日期時間
階層式
Number
Owner
字串
唯一識別碼
ne-businessid 此值不等於指定的企業 ID。 唯一識別碼
ne-userid 此值不等於指定的使用者 ID。 唯一識別碼
內克 Deprecated. 請改用 ne 。 僅用於回溯相容性。 N/A
下一個會計期間 該值在下一個會計期間內。 日期時間
下一個會計年度 該值在下一個會計年度內。 日期時間
下個月 該值在下個月內。 日期時間
下一個-七天 該值在未來 7 天內。 日期時間
下週 該值在下週內。 日期時間
下一個 X 天 此值在下一個指定的天數內。 日期時間
下一個-x-會計期間 此值在下一個指定的會計期間數內。 日期時間
下一個 x 會計年度 該值在下一個指定的會計年度內。 日期時間
下一個 x 小時 此值在下一個指定的小時數內。 日期時間
下一個 x 個月 此值在下一個指定的月數內。 日期時間
下一個 x 週 此值在下一個指定的週數內。 日期時間
下一個 X 年 該值在下一個指定的年數內。 日期時間
明年 該價值在未來 X 年內。 日期時間
非開頭 字串不會以另一個字串開頭。 字串
非介於兩者之間 值不介於兩個值之間。 Number
日期時間
不包含值 選擇值不是指定的值之一。 選擇
不結束 字串不會以另一個字串結尾。 字串
不在 給定的值與子查詢或清單中的值不相符。 Number
不像 字串不符合指定的型樣。 字串
非空值 值不是 Null。 選擇
日期時間
階層式
Number
Owner
字串
唯一識別碼
不低於 傳回階層中不低於參考記錄的所有記錄。 階層式
零 值為 Null。 選擇
日期時間
階層式
Number
Owner
字串
唯一識別碼
比 X 天更舊 此值早於指定的天數。 日期時間
早於 x 小時 此值早於指定的小時數。 日期時間
較舊的 x 分鐘 此值早於指定的分鐘數。 日期時間
早於 x 個月 此值早於指定的月數。 日期時間
超過x週 此值早於指定的週數。 日期時間
年齡超過x歲 此值早於指定的年數。 日期時間
在 值位於指定日期。 日期時間
on-or-之後 此值在指定日期當天或之後。 日期時間
on-or-之前 此值在指定日期或之前。 日期時間
本會計期間 該值在當前會計期間內。 日期時間
本會計年度 該值在當前會計年度內。 日期時間
本月 值在當月內。 日期時間
本週 值在當前一周內。 日期時間
今年 該值在當前年份內。 日期時間
今天 該值等於今天的日期。 日期時間
明天 該值等於明天的日期。 日期時間
下面 傳回階層中參考記錄下方的所有子記錄。 階層式
昨天 該值等於昨天的日期。 日期時間

回到頁首

依資料型別的運算元

本節依照操作者所處理的資料類型來分組。

選擇資料

在使用選擇值 的條件 下，請使用以下運算子。

Operator Description
包含值 選擇值是指定的值之一。
eq 會比較這些值是否相等。
在 該值存在於值清單中。
ne 這兩個值不相等。
不包含值 選擇值不是指定的值之一。
非空值 值不是 Null。
零 值為 Null。

日期時間資料

在 條件下 使用帶有日期和時間值的操作符。

備註

當你設定一個帶有 DateOnly 行為的欄位時，你無法使用適用於小時和分鐘的運算子。 深入瞭解日期和時間欄的行為。

部分營運商的行為取決於該財政年度對環境的設定。 深入瞭解會計年度設定

Operator Description
between 值介於兩個值之間。
eq 會比較這些值是否相等。
gt 值大於比較值。
ge 值大於或等於比較值。
會計期間和年度內 該值在指定的會計期間和年度內。
會計期內 該值在指定的會計期間內。
會計年度內 值在指定的年份內。
in-or-會計期間和年度後 該值在指定的會計期間和年度內或之後。
in-or-會計期間和年度之前 該值在指定的會計期間和年份內或之前。
上一個會計期間 該值在上一個會計期間內。
上一會計年度 該值在上一個會計年度內。
上個月 值在上個月內，包括上個月的第一天和上個月的最後一天。
過去 7 天 該值是過去 7 天內（包括今天）。
上週 該值是前一周內的，包括星期日到星期六。
過去 X 天 此值在先前指定的天數內。
最後 x 會計期間 此值在先前指定的會計期間數內。
過去 x 會計年度 此值在先前指定的會計期間數內。
最後 X 小時 此值在先前指定的小時數內。
過去 X 個月 此值在先前指定的月數內。
過去 X 週 此值在先前指定的週數內。
過去 X 年 該值在先前指定的年數內。
去年 值在前一年內。
le 該值小於或等於比較值。
lt 該值小於比較值。
下一個會計期間 該值在下一個會計期間內。
下一個會計年度 該值在下一個會計年度內。
下個月 該值在下個月內。
下一個-七天 該值在未來 7 天內。
下週 該值在下週內。
下一個 X 天 此值在下一個指定的天數內。
下一個-x-會計期間 此值在下一個指定的會計期間數內。
下一個 x 會計年度 該值在下一個指定的會計年度內。
下一個 x 小時 此值在下一個指定的小時數內。
下一個 x 個月 此值在下一個指定的月數內。
下一個 x 週 此值在下一個指定的週數內。
下一個 X 年 該值在下一個指定的年數內。
明年 該價值在未來 X 年內。
非介於兩者之間 值不介於兩個值之間。
非空值 值不是 Null。
零 值為 Null。
比 X 天更舊 此值早於指定的天數。
早於 x 小時 此值早於指定的小時數。
較舊的 x 分鐘 此值早於指定的分鐘數。
早於 x 個月 此值早於指定的月數。
超過x週 此值早於指定的週數。
年齡超過x歲 此值早於指定的年數。
on-or-之後 此值在指定日期當天或之後。
on-or-之前 此值在指定日期或之前。
在 值位於指定日期。
本會計期間 該值在當前會計期間內。
本會計年度 該值在當前會計年度內。
本月 值在當月內。
本週 值在當前一周內。
今年 該值在當前年份內。
今天 該值等於今天的日期。
明天 該值等於明天的日期。
昨天 該值等於昨天的日期。

階層式資料

在具有階層資料的 條件 下，請使用以下運算子。 深入瞭解查詢階層式資料。

Operator Description
上面 傳回參考記錄階層祖先行中的所有記錄。
eq-or-以上 傳回參考的記錄，以及階層中其上方的所有記錄。
eq-or-下 傳回參考的記錄，以及階層中其下方的所有子記錄。
eq-user或user階層 使用階層式安全性模型時，等於目前使用者或其報告階層。
eq-useroruserhierarchyandteams 使用階層式安全性模型時，等於目前使用者及其小組或其報告階層及其小組。
不低於 傳回階層中不低於參考記錄的所有記錄。
下面 傳回階層中參考記錄下方的所有子記錄。

數字數據

在數值 條件 下使用以下運算子。

Operator Description
between 值介於兩個值之間。
eq-user語言 此值等於使用者的語言。
eq 會比較這些值是否相等。
ge 值大於或等於比較值。
gt 值大於比較值。
在 該值存在於值清單中。
le 該值小於或等於比較值。
lt 該值小於比較值。
ne 這兩個值不相等。
非介於兩者之間 值不介於兩個值之間。
不在 給定的值與子查詢或清單中的值不相符。
非空值 值不是 Null。
零 值為 Null。

擁有者資料

在擁有者值的 條件 下，請使用以下運算元。

Operator Description
eq-user或userteams 記錄由使用者所屬的使用者或小組所擁有。
eq-user團隊 記錄由使用者所屬的使用者或小組所擁有。
eq 會比較這些值是否相等。
在 該值存在於值清單中。
ne 這兩個值不相等。

字串資料

在有字串值 的條件 下，請使用以下運算子。

字串值的所有篩選條件都不區分大小寫。

使用包含以下運算子的萬用字元：like、not-like、bes-gin-with、not-begin-with、end-with、not-end-with。 深入瞭解如何在字串值的條件中使用萬用字元。

Operator Description
開始-以 字串出現在另一個字串的開頭。
結束 字串以另一個字串結尾。
eq 會比較這些值是否相等。
ge 值大於或等於比較值。
gt 值大於比較值。
在 該值存在於值清單中。
le 該值小於或等於比較值。
喜歡 字串會比對指定的型樣。
lt 該值小於比較值。
ne 這兩個值不相等。
非開頭 字串不會以另一個字串開頭。
不結束 字串不會以另一個字串結尾。
不像 字串不符合指定的型樣。
非空值 值不是 Null。
零 值為 Null。

唯一識別碼資料

在具有唯一識別碼（GUID）值的 條件 下，請使用以下運算子。

Operator Description
eq-businessid 此值等於指定的企業 ID。
eq-userid 此值等於指定的使用者 ID。
eq 會比較這些值是否相等。
在 該值存在於值清單中。
ne-businessid 此值不等於指定的企業 ID。
ne-userid 此值不等於指定的使用者 ID。
ne 這兩個值不相等。
非空值 值不是 Null。
零 值為 Null。

回到頁首

營運商詳情

本節包含每個 FetchXML 條件運算子的詳細資訊。

上面

傳回參考記錄階層祖先行中的所有記錄。

深入瞭解查詢階層式資料

資料類型： 階層式

開始-以

字串出現在另一個字串的開頭。

您可以將萬用字元與此運算子搭配使用。 深入瞭解如何在字串值的條件中使用萬用字元。

資料類型： 字串

間

值介於兩個值之間。

此運算子需要兩個值。

<condition attribute="numberofemployees" operator="between">
  <value>6</value>
  <value>20</value>
</condition>

資料類型：

包含值

選擇值是指定的值之一。

資料類型： 選擇

結束

字串以另一個字串結尾。

您可以將萬用字元與此運算子搭配使用。 深入瞭解如何在字串值的條件中使用萬用字元。

資料類型： 字串

eq

會比較這些值是否相等。

資料類型：

eq-businessid

此值等於指定的企業 ID。

資料類型： 唯一識別碼

eq-or-以上

傳回參考的記錄，以及階層中其上方的所有記錄。

深入瞭解查詢階層式資料

資料類型： 階層式

eq-or-下

傳回參考的記錄，以及階層中其下方的所有子記錄。

深入瞭解查詢階層式資料

資料類型： 階層式

eq-userid

此值等於指定的使用者 ID。

這個運算子不需要值。

<condition attribute='ownerid' operator='eq-userid' />

資料類型： 唯一識別碼

eq-user語言

此值等於使用者的語言。

當欄位使用 Power Apps 語言類型時，會儲存一個整數值，代表該語言的 Microsoft Locale ID 值。 此值會與代表呼叫使用者慣用語言的 UserSettings.UILanguageId 進行比較。 這些資料行的 AttributeMetadata.AttributeTypeName.Value 等於 IntegerType，以及 IntegerFormat.Language 的 Format 值。

資料類型： 數字

eq-user或user階層

使用階層式安全性模型時，等於目前使用者或其報告階層。

深入瞭解查詢階層式資料

資料類型： 階層式

eq-useroruserhierarchyandteams

使用階層式安全性模型時，等於目前使用者及其小組或其報告階層及其小組。

深入瞭解查詢階層式資料

資料類型： 階層式

eq-user或userteams

記錄由使用者所屬的使用者或小組所擁有。

資料類型： 擁有者

eq-user團隊

記錄由使用者所屬的使用者或小組所擁有。

資料類型： 擁有者

ge

值大於或等於比較值。

資料類型：

gt

值大於比較值。

資料類型：

在

該值存在於值清單中。

資料類型：

會計期內

該值在指定的會計期間內。

深入瞭解會計年度設定

下列範例顯示 FetchXML 查詢，根據組織的會計年度設定，尋找在任何會計年度的第三期間內履行的所有訂單。 請在條件元素的值欄位中指定財政期間值。 如果組織使用會計月份，則查詢會傳回第三個月的結果。 如果組織使用會計季度，則查詢會傳回第三季的結果。 如果組織使用財政學期，查詢結果不會有結果，因為只有兩個學期，而你提供的數值超出範圍。

<fetch>
   <entity name="order">
      <attribute name="name" />
      <filter type="and">
         <condition attribute="datefulfilled"
            operator="in-fiscal-period"
            value="3" />
      </filter>
   </entity>
</fetch>

資料型別： Datetime

會計期間和年度內

該值在指定的會計期間和年度內。

深入瞭解會計年度設定

下列範例顯示 FetchXML 運算式，根據組織的會計年度設定，尋找 2023 會計年度第三期履行的所有訂單。 如果組織使用會計月份，則查詢會傳回第三個月的結果。 如果組織使用會計季度，則查詢會傳回第三季的結果。 如果組織使用財政學期，查詢結果不會有結果，因為只有兩個學期，而你提供的數值超出範圍。

<fetch>
   <entity name="order">
      <attribute name="name" />
      <filter type="and">
         <condition attribute="datefulfilled"
            operator="in-fiscal-period-and-year">
            <value>3</value>
            <value>2023</value>
         </condition>
      </filter>
   </entity>
</fetch>

資料型別： Datetime

會計年度內

值在指定的年份內。

深入瞭解會計年度設定

下列範例顯示 FetchXML 運算式，可尋找 2023 會計年度建立的所有帳戶。

<fetch>
   <entity name="account">
      <attribute name="name" />
      <filter type="and">
         <condition attribute="createdon"
            operator="in-fiscal-year"
            value="2023" />
      </filter>
   </entity>
</fetch>

資料型別： Datetime

in-or-會計期間和年度後

該值在指定的會計期間和年度內或之後。

深入瞭解會計年度設定

資料型別： Datetime

in-or-會計期間和年度之前

該值在指定的會計期間和年份內或之前。

深入瞭解會計年度設定

資料型別： Datetime

上一個會計期間

該值在上一個會計期間內。

深入瞭解會計年度設定

下列範例顯示 FetchXML 運算式，根據組織的會計年度設定，尋找上一個會計期間內完成的所有訂單。 例如，如果組織使用會計月份，則查詢會傳回在上一個會計月份履行的訂單。 如果組織使用會計季度，則查詢會傳回上一個會計季度履行的訂單。 若組織使用財政學期，查詢會回傳上一財政學期已完成的訂單。

<fetch>
   <entity name="order">
      <attribute name="name" />
      <filter type="and">
         <condition attribute="datefulfilled"
            operator="last-fiscal-period" />
      </filter>
   </entity>
</fetch>

資料型別： Datetime

上一會計年度

該值在上一個會計年度內。

深入瞭解會計年度設定

資料型別： Datetime

上個月

值在上個月內，包括上個月的第一天和上個月的最後一天。

資料型別： Datetime

過去 7 天

該值是過去 7 天內（包括今天）。

資料型別： Datetime

上週

該值是前一周內的，包括星期日到星期六。

資料型別： Datetime

過去 X 天

此值在先前指定的天數內。

資料型別： Datetime

最後 x 會計期間

此值在先前指定的會計期間數內。

深入瞭解會計年度設定

資料型別： Datetime

過去 x 會計年度

此值在先前指定的會計期間數內。

深入瞭解會計年度設定

資料型別： Datetime

最後 X 小時

此值在先前指定的小時數內。

您無法將此運算子套用至設定為使用 DateOnly 行為的資料行。 深入瞭解日期和時間欄的行為

資料型別： Datetime

過去 X 個月

此值在先前指定的月數內。

資料型別： Datetime

過去 X 週

此值在先前指定的週數內。

資料型別： Datetime

過去 X 年

該值在先前指定的年數內。

資料型別： Datetime

去年

值在前一年內。

資料型別： Datetime

le

該值小於或等於比較值。

資料類型：

按讚

字串會比對指定的型樣。

您可以將萬用字元與此運算子搭配使用。 深入瞭解如何在字串值的條件中使用萬用字元。

資料類型： 字串

lt

該值小於比較值。

資料類型：

ne

這兩個值不相等。

資料類型：

ne-businessid

此值不等於指定的企業 ID。

資料類型： 唯一識別碼

ne-userid

此值不等於指定的使用者 ID。

資料類型： 唯一識別碼

NEQ

Deprecated. 請改用 ne 。 僅用於回溯相容性。

下一個會計期間

該值在下一個會計期間內。

深入瞭解會計年度設定

資料型別： Datetime

下一個會計年度

該值在下一個會計年度內。

深入瞭解會計年度設定

資料型別： Datetime

下個月

該值在下個月內。

資料型別： Datetime

下一個-七天

該值在未來 7 天內。

資料型別： Datetime

下週

該值在下週內。

資料型別： Datetime

下一個 X 天

此值在下一個指定的天數內。

資料型別： Datetime

下一個-x-會計期間

此值在下一個指定的會計期間數內。

深入瞭解會計年度設定

資料型別： Datetime

下一個 x 會計年度

該值在下一個指定的會計年度內。

深入瞭解會計年度設定

下列範例顯示 FetchXML 運算式，該運算式會根據組織的會計年度設定，尋找未來三個會計年度內具有預估結束日期的所有商機。 你在條件元素的值欄位指定 的 x 值。

<fetch>
   <entity name="opportunity">
      <attribute name="name" />
      <filter type="and">
         <condition attribute="estimatedclosedate"
            operator="next-x-fiscal-years"
            value="3" />
      </filter>
   </entity>
</fetch>

資料型別： Datetime

下一個 x 小時

此值在下一個指定的小時數內。

您無法將此運算子套用至設定為使用 DateOnly 行為的資料行。 深入瞭解日期和時間欄的行為

資料型別： Datetime

下一個 x 個月

此值在下一個指定的月數內。

資料型別： Datetime

下一個 x 週

此值在下一個指定的週數內。

資料型別： Datetime

下一個 X 年

該值在下一個指定的年數內。

資料型別： Datetime

明年

該價值在未來 X 年內。

資料型別： Datetime

非開頭

字串不會以另一個字串開頭。

您可以將萬用字元與此運算子搭配使用。 深入瞭解如何在字串值的條件中使用萬用字元。

資料類型： 字串

非介於兩者之間

值不介於兩個值之間。

資料類型：

不包含值

選擇值不是指定的值之一。

資料類型： 選擇

不結束

字串不會以另一個字串結尾。

您可以將萬用字元與此運算子搭配使用。 深入瞭解如何在字串值的條件中使用萬用字元。

資料類型： 字串

不在

給定的值與子查詢或清單中的值不相符。

資料類型： 數字

不像

字串不符合指定的型樣。

您可以將萬用字元與此運算子搭配使用。 深入瞭解如何在字串值的條件中使用萬用字元。

資料類型： 字串

非空值

值不是 Null。

資料類型：

不低於

傳回階層中不低於參考記錄的所有記錄。

深入瞭解查詢階層式資料

資料類型： 階層式

null

值為 Null。

資料類型：

比 X 天更舊

此值早於指定的天數。

資料型別： Datetime

早於 x 小時

此值早於指定的小時數。

您無法將此運算子套用至設定為使用 DateOnly 行為的資料行。 深入瞭解日期和時間欄的行為

資料型別： Datetime

較舊的 x 分鐘

此值早於指定的分鐘數。

您無法將此運算子套用至設定為使用 DateOnly 行為的資料行。 深入瞭解日期和時間欄的行為

下列範例顯示傳回超過 30 分鐘的事件的 FetchXML 查詢。

<fetch>
   <entity name="incident">
      <attribute name="title" />
      <attribute name="ticketnumber" />
      <attribute name="createdon" />
      <attribute name="incidentid" />
      <filter type="and">
         <condition attribute="createdon"
            operator="olderthan-x-minutes"
            value="30" />
      </filter>
   </entity>
</fetch>

資料型別： Datetime

早於 x 個月

此值早於指定的月數。

資料型別： Datetime

超過x週

此值早於指定的週數。

資料型別： Datetime

年齡超過x歲

此值早於指定的年數。

資料型別： Datetime

開

值位於指定日期。

資料型別： Datetime

on-or-之後

此值在指定日期當天或之後。

資料型別： Datetime

on-or-之前

此值在指定日期或之前。

資料型別： Datetime

本會計期間

該值在當前會計期間內。

深入瞭解會計年度設定

資料型別： Datetime

本會計年度

該值在當前會計年度內。

深入瞭解會計年度設定

資料型別： Datetime

本月

值在當月內。

資料型別： Datetime

本週

值在當前一周內。

資料型別： Datetime

今年

該值在當前年份內。

資料型別： Datetime

今天

該值等於今天的日期。

資料型別： Datetime

明天

該值等於明天的日期。

資料型別： Datetime

下面

傳回階層中參考記錄下方的所有子記錄。

深入瞭解查詢階層式資料

資料類型： 階層式

昨天

該值等於昨天的日期。

資料型別： Datetime

  • 上次更新時間：