日期範圍

您可以使用 Google Ads 查詢語言，透過下列方式指定日期範圍：

• 自訂日期範圍
• 預定日期範圍
• 預先定義的時間範圍
• 歷來回溯限制

注意： 所有日期範圍和時間範圍都是根據放送帳戶的時區 (customer.time_zone) 評估，而非世界標準時間或 API 用戶端的當地時區。

自訂日期範圍

您可以使用 ISO 8601 擴充格式 (YYYY-MM-DD) 或基本格式 (YYYYMMDD) 指定日期。建議使用擴充格式 (YYYY-MM-DD)，以利閱讀。搭配自訂日期字串使用 BETWEEN 或比較運算子 (=、>、>=、<、<=)：

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

預先定義的日期範圍

搭配使用 DURING 運算子和預先定義的日期範圍常值。DURING 運算子僅支援預先定義的日期範圍，無法與自訂日期字串搭配使用。

有效的預先定義日期範圍清單如下：

日期範圍	報表產生對象
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

預先定義的時間範圍

部分日期欄位是指預先定義的時間範圍，具體如下：

• segments.week
• segments.month
• segments.quarter

使用自訂日期字串 (=、BETWEEN、>=、<=、> 或 <) 篩選這些區隔時，必須指定時間範圍的第一天：

• segments.week：當週的星期一 (例如 '2026-05-04')。
• segments.month：當月第一天 (YYYY-MM-01，例如 '2026-05-01')。
• segments.quarter：日曆季度的第一天 (YYYY-01-01、YYYY-04-01、YYYY-07-01 或 YYYY-10-01)。

如果指定的日期不是該週期的第一天，系統會傳回 QueryError.MISALIGNED_DATE_FOR_FILTER 錯誤。您也可以使用 DURING 運算子和預先定義的日期範圍，篩選這些區隔。

舉例來說，如要指定 2026 年 5 月，請使用下列條件，指定該月的第一天：

segments.month = '2026-05-01'

注意： segments.year 是使用 4 位數年份整數 (例如 segments.year = 2026) 篩選，而非 YYYY-MM-DD 日期字串。

歷來回溯限制

歷來報表資料的可用性取決於所選或篩選日期區隔的精細程度：

• 每日、每週和每小時精細程度 (segments.date、segments.week 和 segments.hour)：支援最長 37 個月的回溯期。如果查詢依 segments.date、segments.week 或 segments.hour 區隔 (或篩選未滿一個月的日期範圍)，且日期超出 37 個月，則在 v24 以上版本會失敗，並傳回 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (在 v23 則傳回 DateRangeError.UNKNOWN)。
• 每月、每季、每年或未區隔的精細程度 (segments.month、segments.quarter、segments.year 或無日期區隔)：最多支援 11 年的歷來資料。如要查詢 37 個月以前的歷來資料，請依 segments.month、segments.quarter、segments.year 區隔，或省略 SELECT 中的日期區隔，並確保 WHERE 日期範圍從當月第一天開始，到當月最後一天結束 (或篩選 segments.month、segments.quarter 或 segments.year)。