日期范围

您可以使用 Google Ads 查询语言按以下方式指定日期范围：

• 自定义日期范围
• 预定义日期范围
• 预定义的时间段
• 历史回溯限制

注意： 所有日期范围和时间段都是相对于投放账号的时区 (customer.time_zone) 而不是世界协调时间 (UTC) 或 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 进行过滤）。