WHERE

指定用于筛选查询结果的一个或多个条件表达式。在条件表达式中，Workday 首先评估带括号的表达式。使用

AND

与

OR

使用逻辑运算符分隔 Workday 查询语言 (WQL) 中的条件表达式。

语法

WHERE 
  field1 = value1  
  AND field2 IN (instance1, instance2) 
  OR field3 IN (inst_refId = referenceID)

参数

参数	描述
field1 , field2 , ... fieldN	条件表达式中字段的别名。
value1 , value2 , ... valueN	要匹配的字段的值。
instance1 , instance2 , ... instanceN	您要匹配的字段值的 Workday 编号。当您运行查询时，Workday 会验证 Workday 编号的格式，如果格式无效，则查询失败。
inst_refId	条件表达式中字段的参考编号类型。
referenceID	要匹配的字段值的参考编号。您可以按参考编号（带或不带双引号）进行筛选。示例 (inst_refId = "referenceID") (inst_refId = referenceID)

比较运算符

运算符	字段数据类型兼容性	描述
=	布尔值日期数值文本	等于
>	日期数值	大于
>=	日期数值	大于或等于。
<	日期数值	小于
<=	日期数值	小于或等于。
!=	布尔值日期数值文本	不相等。
contains	文本	比较值是字段值的子集。不区分大小写。示例： “Cat”包含“AT”。
not contains	文本	比较值不是字段值的子集。不区分大小写。示例： “Cat”不包含“dog”。
endswith	文本	比较值是字段值的子集。字段值的最后一个字符与比较值的最后一个字符匹配。不区分大小写。示例： “Cat”以“AT”结尾。
in	实例文本	该字段与某个条件的 1 个或多个可能值匹配。
is empty	布尔值日期实例数值文本	该字段没有值。
is not empty	布尔值日期实例数值文本	该字段具有一个值。
not in	实例文本	该字段不匹配任何可能的条件值。
startswith	文本	比较值是字段值的子集。字段值的第一个字符与比较值的第一个字符匹配。不区分大小写。示例： “Cat”以“CA”开头。

日期和时间格式

WQL 支持采用协调世界时 (UTC) 或太平洋标准时间 (PST) 的日期和日期时间。

日期和时间	格式
日期	YYYY-MM-DD
时间（24 小时制）	时:分:秒
具有时区的日期时间	PST：年-月-日 - 时:分:秒世界标准时间：YYYY-MM-DD HH:MM:SSZ

示例

从

allWorkers

数据源返回员工和地点字段，其中“地点”为“旧金山”，“Workday 编号”为特定员工：

SELECT worker, location  
FROM allWorkers
WHERE location in (Location_ID = San_Francisco_site) AND worker in (3895af7993ff4c509cbea2e1817172e0)

通过在日期时间值中添加 Z，返回在 2020 年 8 月 1 日上午 7 点 15 分到 2020 年 8 月 30 日上午 7 点 45 日（使用协调世界时 (UTC)）之间获得批准的可收费交易：

SELECT billableProject, projectCompany, approvalDate 
FROM billableProjectTransactions 
WHERE (approvalDate >= '2020-08-01 07:15:00Z' AND approvalDate <= '2020-08-30 07:45:00Z')

限制

WHERE ON 子句必须位于 WHERE 子句之前。