日期範圍
您可以透過下列兩種方式,使用 Search Ads 360 查詢語言指定日期範圍:
自訂日期範圍
您可以使用 ISO 8601(YYYY-MM-DD
) 格式指定日期:
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
時間範圍
部分日期欄位會參照預先定義的時間範圍,具體如下:
segments.week
segments.month
segments.quarter
篩選這些區隔時,您可以使用 =
運算子搭配時間範圍的第一天日期。從 v9 開始,如果您指定的日期不是週期的第一天,系統會傳回 MISALIGNED_DATE_FOR_FILTER
錯誤。
舉例來說,如要指定 2021 年的 5 月,請使用下列條件,指定該月的首日:
segments.month = '2021-05-01'
預定日期範圍
有效的預先定義日期範圍清單如下:
日期範圍 |
報表產生對象為... |
TODAY |
僅限今天。 |
YESTERDAY |
僅限昨天。 |
LAST_7_DAYS |
過去 7 天 (不含今天)。 |
LAST_BUSINESS_WEEK |
上一個工作週的 5 天工作日 (週一至週五)。 |
THIS_MONTH |
當月所有日期。 |
LAST_MONTH |
上個月的所有日期。 |
LAST_14_DAYS |
過去 14 天 (不含今天)。 |
LAST_30_DAYS |
過去 30 天 (不含今天)。 |
THIS_WEEK_SUN_TODAY |
上一個星期日和目前日期之間的期間。 |
THIS_WEEK_MON_TODAY |
上一個星期一到當天之間的期間。 |
LAST_WEEK_SUN_SAT |
從前一週日開始的 7 天期間。 |
LAST_WEEK_MON_SUN |
從上週一開始的 7 天期間。 |
範例:
segments.date DURING LAST_30_DAYS
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-03-03 (世界標準時間)。
[null,null,["上次更新時間:2025-03-03 (世界標準時間)。"],[[["The Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges."],["Custom date ranges can be defined using ISO 8601 format and operators like `BETWEEN`, `\u003e=`, and `\u003c=`."],["Time period segments such as week, month, and quarter require filtering with the first day of the period using the `=` operator."],["Predefined date ranges offer shortcuts for common periods like `TODAY`, `LAST_7_DAYS`, `LAST_MONTH`, and others, simplifying query construction."],["Specifying a date that is not the first day of a period for segments like `segments.month` will result in a `MISALIGNED_DATE_FOR_FILTER` error."]]],["The Search Ads 360 Query Language uses custom or predefined date ranges. Custom ranges utilize ISO 8601 format (YYYY-MM-DD) for specific dates (e.g., `segments.date BETWEEN '2019-01-01' AND '2019-01-31'`). For segments like `week`, `month`, or `quarter`, filters must use the first day of the period. Predefined ranges, such as `TODAY`, `LAST_7_DAYS`, or `LAST_MONTH`, offer shortcuts (e.g., `segments.date DURING LAST_30_DAYS`).\n"]]