条件运算符值

若要了解如何使用这些值，请参阅 使用 FetchXml 筛选行。

返回页首

按数据类型

本部分按可以使用的数据类型对运算符进行分组。

• 选择数据
• 日期/时间数据
• 分层数据
• 数字数据
• 所有者数据
• 字符串数据
• 唯一标识符数据

选择数据

使用选项值在 条件 中使用以下运算符。

日期/时间数据

使用日期和时间值在 条件 中使用以下运算符。

分层数据

在 条件 中使用分层数据时使用以下运算符。 详细了解如何查询分层数据。

数字数据

在 条件 中使用数值时使用以下运算符。

所有者数据

使用所有者值在 条件 中使用以下运算符。

字符串数据

在 条件 中使用字符串值时使用以下运算符。

字符串值的所有筛选条件都区分大小写。

可对以下运算符使用通配符： 例如， 不类似、 以开头、 非开头、 结尾和 非结尾。 详细了解如何在字符串值条件下使用通配符

唯一标识符数据

在 条件 中使用唯一标识符 （GUID） 值时使用以下运算符。

返回页首

详细信息

本部分包括有关每个 FetchXml 条件运算符的详细信息。

以上

返回引用记录的分层祖先行中的所有记录。

详细了解如何查询分层数据

数据类型： 分层

begins-with

该字符串发生在另一个字符串的开头。

可以将通配符用于此运算符。 详细了解如何在字符串值条件下使用通配符。

数据类型： 字符串

之间

该值介于两个值之间。

此运算符需要两个值。

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

数据类型：

• 数字
• 日期/时间

contain-values

选择值是指定值之一。

数据类型： 选项

ends-with

字符串以另一个字符串结尾。

可以将通配符用于此运算符。 详细了解如何在字符串值条件下使用通配符。

数据类型： 字符串

eq

为相等性比较这些值。

数据类型：

• Choice
• 日期/时间
• 层次
• 数字
• Owner
• 字符串
• 唯一标识符

eq-businessid

该值等于指定的业务 ID。

数据类型： 唯一标识符

eq-or-above

返回引用的记录及其上的所有记录在层次结构中。

详细了解如何查询分层数据

数据类型： 分层

eq-or-under

返回在层次结构中引用的记录及其下方的所有子记录。

详细了解如何查询分层数据

数据类型： 分层

eq-userid

该值等于指定的用户 ID。

此运算符不需要任何值。

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

数据类型： 唯一标识符

eq-userlanguage

该值等于用户的语言。

当列使用 Power Apps 语言 类型时，它是一个整数值，用于存储语言 的Microsoft区域设置 ID 值 。 该值与表示调用用户首选语言的 UserSettings.UILanguageId 进行比较。 这些列具有 AttributeMetadata.AttributeTypeName.Value 等于 IntegerType 和 IntegerFormat.Language的格式值。

数据类型： 数字

eq-useroruserhierarchy

使用分层安全模型时，等于当前用户或其报告层次结构。

详细了解如何查询分层数据

数据类型： 分层

eq-useroruserhierarchyandteams

使用分层安全模型时，等于当前用户及其团队或其报告层次结构及其团队。

详细了解如何查询分层数据

数据类型： 分层

eq-useroruserteams

记录由用户所属的用户或团队拥有。

数据类型： 所有者

eq-userteams

记录由用户所属的用户或团队拥有。

数据类型： 所有者

ge

该值大于或等于比较值。

数据类型：

• 数字
• 日期/时间
• 字符串

gt

该值大于比较值。

数据类型：

• 数字
• 日期/时间
• 字符串

in

该值存在于值列表中。

数据类型：

• Choice
• 数字
• 唯一标识符
• Owner
• 字符串 最多 850 个字符

in-fiscal-period

该值在指定的会计周期内。

详细了解会计年度设置

下面的示例演示了一个 FetchXML 查询，该查询根据组织的会计年度设置查找任何会计年度第三个周期内完成的所有订单。 会计周期值是在条件元素的值列中指定的。 如果组织使用会计月，则查询将返回第三个月的结果。 如果组织使用会计季度，查询将返回第三季度的结果。 如果组织使用会计学期，则不返回任何结果;只有两个学期，因此提供的值不一定。

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

数据类型： Datetime

in-fiscal-period-and-year

该值在指定的会计周期和年份内。

详细了解会计年度设置

下面的示例演示了一个 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-after-fiscal-period-and-year

该值在指定的财政周期和年份内或之后。

详细了解会计年度设置

数据类型： Datetime

in-or-before-fiscal-period-and-year

该值在指定的财政周期和年份内或之前。

详细了解会计年度设置

数据类型： Datetime

last-fiscal-period

该值在上一个会计周期内。

详细了解会计年度设置

下面的示例演示了一个 FetchXML 表达式，该表达式根据组织的会计年度设置查找在上一个财政周期内完成的所有订单。 例如，如果组织使用会计月份，查询将返回上一个会计月中已完成的订单。 如果组织使用会计季度，查询将返回上一个会计季度中完成的订单。 如果组织使用会计学期，则返回上一个会计学期中完成的订单。

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

数据类型： Datetime

last-fiscal-year

该值在上一个会计年度内。

详细了解会计年度设置

数据类型： Datetime

上月

该值在上月内，包括上个月的第一天和上个月的最后一天。

数据类型： Datetime

过去七天

该值在前七天（包括今天）内。

数据类型： Datetime

last-week

该值在前一周内，包括星期日到星期六。

数据类型： Datetime

last-x-days

该值在之前的指定天数内。

数据类型： Datetime

last-x-fiscal-periods

该值在以前的指定会计周期数内。

详细了解会计年度设置

数据类型： Datetime

last-x-fiscal-years

该值在以前的指定会计周期数内。

详细了解会计年度设置

数据类型： Datetime

last-x-hours

该值在之前的指定小时数内。

不能将此运算符应用于配置为使用该 DateOnly 行为的列。 详细了解日期和时间列的行为

数据类型： Datetime

last-x-month

该值在之前的指定月数内。

数据类型： Datetime

last-x-weeks

该值在之前的指定周数内。

数据类型： Datetime

last-x-years

该值在之前的指定年份内。

数据类型： Datetime

去年

该值在上一年内。

数据类型： Datetime

le

该值小于或等于比较值。

数据类型：

• 数字
• 日期/时间
• 字符串

赞

字符串与指定的模式匹配。

可以将通配符用于此运算符。 详细了解如何在字符串值条件下使用通配符。

数据类型： 字符串

lt

该值小于比较值。

数据类型：

• 数字
• 日期/时间
• 字符串

ne

这两个值不相等。

数据类型：

• Choice
• 日期/时间
• 层次
• 数字
• Owner
• 字符串
• 唯一标识符

ne-businessid

该值不等于指定的业务 ID。

数据类型： 唯一标识符

ne-userid

该值不等于指定的用户 ID。

数据类型： 唯一标识符

NEQ

已弃用。 请改用 ne 。 仅为向后兼容性而保留。

next-fiscal-period

该值在下一个财政周期内。

详细了解会计年度设置

数据类型： Datetime

next-fiscal-year

该值在下一个会计年度内。

详细了解会计年度设置

数据类型： Datetime

next-month

该值在下个月内。

数据类型： Datetime

next-seven-days

该值在接下来的七天内。

数据类型： Datetime

下周

该值在下周内。

数据类型： Datetime

next-x-days

该值位于下一个指定的天数内。

数据类型： Datetime

next-x-fiscal-periods

该值位于下一个指定的会计周期数内。

详细了解会计年度设置

数据类型： Datetime

next-x-fiscal-years

该值位于下一个指定的会计年度内。

详细了解会计年度设置

下面的示例演示了一个 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

next-x-hours

该值位于下一个指定的小时数内。

不能将此运算符应用于配置为使用该 DateOnly 行为的列。 详细了解日期和时间列的行为

数据类型： Datetime

next-x-month

该值位于下一个指定的月份内。

数据类型： Datetime

next-x-weeks

该值位于下一个指定的周数内。

数据类型： Datetime

next-x-years

该值位于下一个指定的年份内。

数据类型： Datetime

next-year

该值在未来 X 年内。

数据类型： Datetime

not-begin-with

该字符串不以另一个字符串开头。

可以将通配符用于此运算符。 详细了解如何在字符串值条件下使用通配符。

数据类型： 字符串

not-between

该值不介于两个值之间。

数据类型：

• 数字
• 日期/时间

not-contain-values

选择值不是指定值之一。

数据类型： 选项

not-end-with

该字符串不以另一个字符串结尾。

可以将通配符用于此运算符。 详细了解如何在字符串值条件下使用通配符。

数据类型： 字符串

not-in

给定值与子查询或列表中的值不匹配。

数据类型： 数字

not-like

字符串与指定的模式不匹配。

可以将通配符用于此运算符。 详细了解如何在字符串值条件下使用通配符。

数据类型： 字符串

not-null

该值不为 null。

数据类型：

• Choice
• 日期/时间
• 层次
• 数字
• Owner
• 字符串
• 唯一标识符

not-under

返回层次结构中引用的记录下方的所有记录。

详细了解如何查询分层数据

数据类型： 分层

null

该值为 null。

数据类型：

• Choice
• 日期/时间
• 层次
• 数字
• Owner
• 字符串
• 唯一标识符

olderthan-x-days

该值早于指定的天数。

数据类型： Datetime

olderthan-x-hours

该值早于指定的小时数。

不能将此运算符应用于配置为使用该 DateOnly 行为的列。 详细了解日期和时间列的行为

数据类型： Datetime

olderthan-x-minutes

该值早于指定的分钟数。

不能将此运算符应用于配置为使用该 DateOnly 行为的列。 详细了解日期和时间列的行为

以下示例显示了一个 FetchXML 查询，该查询返回超过 30 分钟的事件。

<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

olderthan-x-months

该值早于指定的月份数。

数据类型： Datetime

olderthan-x-weeks

该值早于指定的周数。

数据类型： Datetime

olderthan-x-years

该值早于指定的年数。

数据类型： Datetime

上

该值在指定的日期。

数据类型： Datetime

on-or-after

该值在指定日期或之后。

数据类型： Datetime

on-or-before

该值位于指定日期或日期之前。

数据类型： Datetime

this-fiscal-period

该值在当前会计周期内。

详细了解会计年度设置

数据类型： Datetime

本财政年度

该值在当前会计年度内。

详细了解会计年度设置

数据类型： Datetime

本月

该值在当前月份内。

数据类型： Datetime

本周

该值在当前周内。

数据类型： Datetime

今年

该值在当前年份内。

数据类型： Datetime

今天

该值等于今天的日期。

数据类型： Datetime

明天

该值等于明天的日期。

数据类型： Datetime

下

返回层次结构中引用的记录下方的所有子记录。

详细了解如何查询分层数据

数据类型： 分层

昨天

该值等于昨天的日期。

数据类型： Datetime