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 (含或不含雙引號) 進行篩選。 範例
|
比較運算子
運算子 | 欄位資料類型相容性 | 說明 |
|---|---|---|
= | 布林運算子 日期 數值 文字 | 相等。 |
> | 日期 數值 | 大於。 |
>= | 日期 數值 | 大於或等於。 |
< | 日期 數值 | 小於。 |
<= | 日期 數值 | 小於或等於。 |
!= | 布林運算子 日期 數值 文字 | 不相等。 |
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 子句之前。