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

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

segments.month = '2026-05-01'

Исторические ограничения на ретроспективный анализ

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

• Ежедневная, еженедельная и почасовая детализация ( 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 ).