日期範圍

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

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

自訂日期範圍

您可以指定 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運算子僅支援預先定義的日期範圍，無法搭配自訂日期字串使用。

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

範例：

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.date、segments.week 和 segments.hour)：支援最多 37 個月的回溯期。如果查詢依 segments.date、segments.week 或 segments.hour 區隔 (或依低於一個月的日期範圍篩選)，且日期超出 37 個月的時間範圍，則在第 24 版以上 (或第 23 版的 DateRangeError.UNKNOWN) 中會失敗，並顯示 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED。
• 每月、每季、每年或未區隔的精細程度 (segments.month、segments.quarter、segments.year 或沒有日期區隔)：支援最多 11 年的歷來資料。如要查詢 37 個月以外的歷史資料，請依 segments.month、segments.quarter、segments.year 分段，或在 SELECT 中省略日期分段，並確保 WHERE 日期範圍從當月第一天開始，到當月最後一天結束 (或篩選 segments.month、segments.quarter 或 segments.year)。