Períodos
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a linguagem de consulta do Google Ads, é possível especificar o período das seguintes maneiras:
Período personalizado
Você pode especificar datas no formato ISO 8601 estendido
(YYYY-MM-DD) ou básico (YYYYMMDD). Por exemplo:
segments.date BETWEEN '2024-01-01' AND '2024-01-31'
segments.date >= '20241001' AND segments.date <= '20241031'
Período predefinido
Confira a lista de períodos predefinidos válidos:
| Período |
Os relatórios são gerados para... |
TODAY |
Somente hoje. |
YESTERDAY |
Somente ontem. |
LAST_7_DAYS |
Os últimos 7 dias não incluindo hoje. |
LAST_BUSINESS_WEEK
|
Os cinco dias da semana comercial anterior (de segunda a sexta-feira). |
THIS_MONTH |
Todos os dias do mês atual. |
LAST_MONTH |
Todos os dias do último mês. |
LAST_14_DAYS |
Os últimos 14 dias não incluindo hoje. |
LAST_30_DAYS |
Os últimos 30 dias não incluindo hoje. |
THIS_WEEK_SUN_TODAY
|
O período entre o domingo anterior e o dia atual. |
THIS_WEEK_MON_TODAY
|
O período entre a segunda-feira anterior e o dia atual. |
LAST_WEEK_SUN_SAT |
O período de sete dias que começa no domingo anterior. |
LAST_WEEK_MON_SUN |
O período de sete dias que começa na segunda-feira anterior. |
Exemplo:
segments.date DURING LAST_30_DAYS
Período predefinido
Alguns campos de data se referem a um período predefinido, especificamente:
segments.weeksegments.monthsegments.quarter
Ao filtrar esses segmentos, use o operador = com a data do primeiro dia do período. Se você especificar uma data que não seja o primeiro dia de um período, um erro MISALIGNED_DATE_FOR_FILTER será retornado.
Por exemplo, para especificar o mês de maio de 2024, use a seguinte condição, especificando o primeiro dia desse mês:
segments.month = '2024-05-01'
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-27 UTC.
[null,null,["Última atualização 2025-08-27 UTC."],[[["\u003cp\u003eGoogle Ads Query Language allows you to specify date ranges using custom dates, predefined date ranges like \u003ccode\u003eTODAY\u003c/code\u003e or \u003ccode\u003eLAST_30_DAYS\u003c/code\u003e, and predefined time periods for week, month, or quarter.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format, either extended (\u003ccode\u003eYYYY-MM-DD\u003c/code\u003e) or basic (\u003ccode\u003eYYYYMMDD\u003c/code\u003e), within a \u003ccode\u003eBETWEEN\u003c/code\u003e or \u003ccode\u003e>=\u003c/code\u003e and \u003ccode\u003e<=\u003c/code\u003e clause.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges provide shortcuts for common timeframes, such as \u003ccode\u003eLAST_BUSINESS_WEEK\u003c/code\u003e or \u003ccode\u003eTHIS_MONTH\u003c/code\u003e, simplifying date selection in queries.\u003c/p\u003e\n"],["\u003cp\u003eWhen filtering by predefined time periods (week, month, quarter), use the \u003ccode\u003e=\u003c/code\u003e operator with the first day of the period to avoid errors.\u003c/p\u003e\n"]]],[],null,["# Date Ranges\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe Google Ads Query Language lets you specify the date range in these ways:\n\n- [Custom date range](#custom)\n- [Predefined date range](#date-range)\n- [Predefined time period](#time-period)\n\nCustom date range\n-----------------\n\nYou can specify dates in [ISO 8601](//en.wikipedia.org/wiki/ISO_8601) extended\n(`YYYY-MM-DD`) or basic (`YYYYMMDD`) format, for example: \n\n segments.date BETWEEN '2024-01-01' AND '2024-01-31'\n\n segments.date \u003e= '20241001' AND segments.date \u003c= '20241031'\n\nPredefined date range\n---------------------\n\nThe list of valid predefined date ranges is as follows:\n\n| Date range | Reports are generated for... |\n|-----------------------|--------------------------------------------------------------------------------|\n| `TODAY` | Today only. |\n| `YESTERDAY` | Yesterday only. |\n| `LAST_7_DAYS` | The last 7 days not including today. |\n| `LAST_BUSINESS_WEEK` | The 5 day business week, Monday through Friday, of the previous business week. |\n| `THIS_MONTH` | All days in the current month. |\n| `LAST_MONTH` | All days in the previous month. |\n| `LAST_14_DAYS` | The last 14 days not including today. |\n| `LAST_30_DAYS` | The last 30 days not including today. |\n| `THIS_WEEK_SUN_TODAY` | The period between the previous Sunday and the current day. |\n| `THIS_WEEK_MON_TODAY` | The period between the previous Monday and the current day. |\n| `LAST_WEEK_SUN_SAT` | The 7-day period starting with the previous Sunday. |\n| `LAST_WEEK_MON_SUN` | The 7-day period starting with the previous Monday. |\n\nExample: \n\n segments.date DURING LAST_30_DAYS\n\nPredefined time period\n----------------------\n\nSome date fields refer to a predefined period of time, specifically:\n\n- `segments.week`\n- `segments.month`\n- `segments.quarter`\n\nWhen filtering on these segments, you can use the `=` operator with the date\nthat is the first day of the time period. If you specify a date that isn't the\nfirst day of a period, a `MISALIGNED_DATE_FOR_FILTER` error is returned.\n\nFor example, to specify the month of May in the year 2024, use the\nfollowing condition, specifying the first day of that month: \n\n segments.month = '2024-05-01'"]]
