Диапазоны дат

В Google Ads Query Language диапазон дат можно указать следующими способами:

• Свой диапазон дат
• Стандартный диапазон дат
• Заданный период времени
• Ограничения на период ретроспективного анализа

Примечание. Все диапазоны дат и периоды времени оцениваются относительно часового пояса аккаунта для показа рекламы (customer.time_zone), а не UTC или местного часового пояса API-клиента.

Свой диапазон дат

Даты можно указывать в расширенном (YYYY-MM-DD) или базовом (YYYYMMDD) формате ISO 8601. Для удобства чтения рекомендуется использовать расширенный формат (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	Пятидневная рабочая неделя (с понедельника по пятницу) предыдущей рабочей недели.
THIS_MONTH	За все дни текущего месяца.
LAST_MONTH	За все дни прошлого месяца.
LAST_14_DAYS	За последние 14 дней, не включая текущий.
LAST_30_DAYS	За последние 30 дней, не включая текущий.
THIS_WEEK_SUN_TODAY	Период с предыдущего воскресенья до текущего дня.
THIS_WEEK_MON_TODAY	Период между предыдущим понедельником и текущим днем.
LAST_WEEK_SUN_SAT	Семидневный период, начинающийся с предыдущего воскресенья.
LAST_WEEK_MON_SUN	Семидневный период, начинающийся с предыдущего понедельника.

Пример:

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 года, используйте следующее условие, указав первый день этого месяца:

segments.month = '2026-05-01'

Примечание. segments.year фильтруется с помощью четырехзначного целого числа, обозначающего год (например, segments.year = 2026), а не строки даты YYYY-MM-DD.

Ограничения на период ретроспективного анализа

Доступность данных отчетов зависит от детализации выбранных или отфильтрованных сегментов дат:

• Детализация по дням, неделям и часам (segments.date, segments.week и segments.hour). Поддерживается период ретроспективного анализа до 37 месяцев. Запросы, сегментированные по segments.date, segments.week или segments.hour (или отфильтрованные по диапазону дат меньше месяца) для дат за пределами 37-месячного окна, завершаются ошибкой DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED в версии 24 и более поздних (или DateRangeError.UNKNOWN в версии 23).
• Детализация по месяцам, кварталам, годам или без сегментации (segments.month, segments.quarter, segments.year или без сегмента по дате). Поддерживается статистика за период до 11 лет. Чтобы запросить статистику за период, превышающий 37 месяцев, выполните сегментирование по segments.month, segments.quarter или segments.year либо не используйте сегменты по дате в SELECT. При этом диапазон дат WHERE должен начинаться в первый день месяца и заканчиваться в последний день месяца (или же можно использовать фильтры по segments.month, segments.quarter или segments.year).