Date Ranges
Stay organized with collections
Save and categorize content based on your preferences.
The Google Ads Query Language lets you specify the date range in these ways:
Custom date range
You can specify dates in ISO 8601 extended
(YYYY-MM-DD) or basic (YYYYMMDD) format, for example:
segments.date BETWEEN '2024-01-01' AND '2024-01-31'
segments.date >= '20241001' AND segments.date <= '20241031'
Predefined date range
The list of valid predefined date ranges is as follows:
| Date range |
Reports are generated for... |
TODAY |
Today only. |
YESTERDAY |
Yesterday only. |
LAST_7_DAYS |
The last 7 days not including today. |
LAST_BUSINESS_WEEK
|
The 5 day business week, Monday through Friday, of
the previous business week. |
THIS_MONTH |
All days in the current month. |
LAST_MONTH |
All days in the previous month. |
LAST_14_DAYS |
The last 14 days not including today. |
LAST_30_DAYS |
The last 30 days not including today. |
THIS_WEEK_SUN_TODAY
|
The period between the previous Sunday and the
current day. |
THIS_WEEK_MON_TODAY
|
The period between the previous Monday and the
current day. |
LAST_WEEK_SUN_SAT |
The 7-day period starting with the previous Sunday. |
LAST_WEEK_MON_SUN |
The 7-day period starting with the previous Monday. |
Example:
segments.date DURING LAST_30_DAYS
Predefined time period
Some date fields refer to a predefined period of time, specifically:
segments.weeksegments.monthsegments.quarter
When filtering on these segments, you can use the = operator with the date
that is the first day of the time period. If you specify a date that isn't the
first day of a period, a MISALIGNED_DATE_FOR_FILTER error is returned.
For example, to specify the month of May in the year 2024, use the
following condition, specifying the first day of that month:
segments.month = '2024-05-01'
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 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'"]]
