跳至主要內容
Administrator Guide
上次更新時間 :2024-02-09
WHERE

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 ID。
當您執行查詢時,Workday 會驗證 Workday ID 的格式,並在格式無效時執行查詢。
inst_refId
條件運算式中欄位的參照 ID 類型。
referenceID
您要比對的欄位值的參考 ID。
您可以依參考 ID (含或不含雙引號) 進行篩選。
範例
  • (inst_refId = "referenceID")
  • (inst_refId = referenceID)

比較運算子

運算子
欄位資料類型相容性
說明
=
布林運算子
日期
數值
文字
相等。
>
日期
數值
大於。
>=
日期
數值
大於或等於。
<
日期
數值
小於。
<=
日期
數值
小於或等於。
!=
布林運算子
日期
數值
文字
不相等。
contains
文字
比較值是欄位值的子集。
不區分大小寫。
範例︰ 類別中包含「AT」。
not contains
文字
此比較值不是欄位值的子集。
不區分大小寫。
範例︰ 「Cat」中不包含「Dog」。
endswith
文字
比較值是欄位值的子集。欄位值的最後一個字元與比較值的最後一個字元相符。
不區分大小寫。
範例︰ CAT 以「AT」結尾
in
實例
文字
「」欄位符合條件的 1 或多個可能值。
is empty
布林運算子
日期
實例
數值
文字
欄位沒有值。
is not empty
布林運算子
日期
實例
數值
文字
欄位有值。
not in
實例
文字
「」欄位與任何條件的可能值都不相符。
startswith
文字
比較值是欄位值的子集。欄位值的第一個字元與比較值的第一個字元相符。
不區分大小寫。
範例︰ 開頭為 CA。

日期與時間格式

WQL 支援採用協調世界時間 (UTC) 或太平洋標準時間 (PST) 的日期和日期時間。
日期與時間
格式
日期
YYYY-MM-DD
時間 (24 小時制)
HH:MM:SS
日期時間 (含時區)
太平洋標準時間︰YYYY-MM-DD HH:MM:SS
UTC︰YYYY-MM-DD HH:MM:SSZ

範例

allWorkers
資料來源傳回員工和地點欄位,地點為舊金山,Workday ID 為特定員工︰
SELECT worker, location FROM allWorkers WHERE location in (Location_ID = San_Francisco_site) AND worker in (3895af7993ff4c509cbea2e1817172e0)
傳回使用協調世界時 (UTC) 對 2020 年 8 月 1 日上午 7:15 至 2020 年 8 月 30 日上午 7:45 核准的可計費交易,方法是在 datetime 值上加上 Z︰
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 子句之前。