共用方式為

條件運算子值

若要瞭解如何使用這些值，請參閱 使用 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、 begins-with、 not-begin-with、 ends-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 地區設定 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>

資料類型： 日期時間

會計期間和年度內

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

深入瞭解會計年度設定

下列範例顯示 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>

資料類型： 日期時間

會計年度內

值在指定的年份內。

深入瞭解會計年度設定

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

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

資料類型： 日期時間

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

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

深入瞭解會計年度設定

資料類型： 日期時間

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

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

深入瞭解會計年度設定

資料類型： 日期時間

上一個會計期間

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

深入瞭解會計年度設定

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

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

資料類型： 日期時間

上一會計年度

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

深入瞭解會計年度設定

資料類型： 日期時間

上個月

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

資料類型： 日期時間

過去 7 天

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

資料類型： 日期時間

上週

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

資料類型： 日期時間

過去 X 天

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

資料類型： 日期時間

最後 x 會計期間

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

深入瞭解會計年度設定

資料類型： 日期時間

過去 x 會計年度

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

深入瞭解會計年度設定

資料類型： 日期時間

最後 X 小時

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

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

資料類型： 日期時間

過去 X 個月

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

資料類型： 日期時間

過去 X 週

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

資料類型： 日期時間

過去 X 年

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

資料類型： 日期時間

去年

值在前一年內。

資料類型： 日期時間

le

該值小於或等於比較值。

數據類型：

按讚

字串會比對指定的型樣。

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

資料類型： 字串

lt

該值小於比較值。

數據類型：

ne

這兩個值不相等。

數據類型：

ne-businessid

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

資料類型： 唯一識別碼

ne-userid

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

資料類型： 唯一識別碼

NEQ

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

下一個會計期間

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

深入瞭解會計年度設定

資料類型： 日期時間

下一個會計年度

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

深入瞭解會計年度設定

資料類型： 日期時間

下個月

該值在下個月內。

資料類型： 日期時間

下一個-七天

該值在未來 7 天內。

資料類型： 日期時間

下週

該值在下週內。

資料類型： 日期時間

下一個 X 天

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

資料類型： 日期時間

下一個-x-會計期間

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

深入瞭解會計年度設定

資料類型： 日期時間

下一個 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>

資料類型： 日期時間

下一個 x 小時

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

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

資料類型： 日期時間

下一個 x 個月

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

資料類型： 日期時間

下一個 x 週

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

資料類型： 日期時間

下一個 X 年

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

資料類型： 日期時間

明年

該價值在未來 X 年內。

資料類型： 日期時間

非開頭

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

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

資料類型： 字串

非介於兩者之間

值不介於兩個值之間。

數據類型：

不包含值

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

資料類型： 選擇

不結束

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

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

資料類型： 字串

不在

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

資料類型： 數字

不像

字串不符合指定的型樣。

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

資料類型： 字串

非空值

值不是 Null。

數據類型：

不低於

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

深入瞭解查詢階層式資料

資料類型： 階層式

null

值為 Null。

數據類型：

比 X 天更舊

此值早於指定的天數。

資料類型： 日期時間

早於 x 小時

此值早於指定的小時數。

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

資料類型： 日期時間

較舊的 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>

資料類型： 日期時間

早於 x 個月

此值早於指定的月數。

資料類型： 日期時間

超過x週

此值早於指定的週數。

資料類型： 日期時間

年齡超過x歲

此值早於指定的年數。

資料類型： 日期時間

開

值位於指定日期。

資料類型： 日期時間

on-or-之後

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

資料類型： 日期時間

on-or-之前

此值在指定日期或之前。

資料類型： 日期時間

本會計期間

該值在當前會計期間內。

深入瞭解會計年度設定

資料類型： 日期時間

本會計年度

該值在當前會計年度內。

深入瞭解會計年度設定

資料類型： 日期時間

本月

值在當月內。

資料類型： 日期時間

本週

值在當前一周內。

資料類型： 日期時間

今年

該值在當前年份內。

資料類型： 日期時間

今天

該值等於今天的日期。

資料類型： 日期時間

明天

該值等於明天的日期。

資料類型： 日期時間

下面

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

深入瞭解查詢階層式資料

資料類型： 階層式

昨天

該值等於昨天的日期。

資料類型： 日期時間

  • Last updated on