Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
The upper bound of the date range, inclusive. Must specify a positive value for year, month, and day.
Date
Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:
A full date, with non-zero year, month, and day values.
A month and day, with a zero year (for example, an anniversary).
A year on its own, with a zero month and a zero day.
A year and month, with a zero day (for example, a credit card expiration date).
Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
month
integer
Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
day
integer
Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
[null,null,["Last updated 2025-04-02 UTC."],[[["\u003cp\u003eDateRange specifies a date range with inclusive start and end dates, requiring positive values for year, month, and day in both.\u003c/p\u003e\n"],["\u003cp\u003eDate represents a full or partial calendar date (year, month, day) relative to the Gregorian Calendar, allowing for flexible date specifications.\u003c/p\u003e\n"],["\u003cp\u003eDate can be used to represent a full date, a month and day, a year, or a year and month.\u003c/p\u003e\n"]]],[],null,["# DateRange\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [Date](#Date)\n - [JSON representation](#Date.SCHEMA_REPRESENTATION)\n\nA date range.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"startDate\": { object (/display-video/api/reference/rest/v3/DateRange#Date) }, \"endDate\": { object (/display-video/api/reference/rest/v3/DateRange#Date) } } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `startDate` | `object (`[Date](/display-video/api/reference/rest/v3/DateRange#Date)`)` The lower bound of the date range, inclusive. Must specify a positive value for `year`, `month`, and `day`. |\n| `endDate` | `object (`[Date](/display-video/api/reference/rest/v3/DateRange#Date)`)` The upper bound of the date range, inclusive. Must specify a positive value for `year`, `month`, and `day`. |\n\nDate\n----\n\nRepresents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:\n\n- A full date, with non-zero year, month, and day values.\n- A month and day, with a zero year (for example, an anniversary).\n- A year on its own, with a zero month and a zero day.\n- A year and month, with a zero day (for example, a credit card expiration date).\n\nRelated types:\n\n- `google.type.TimeOfDay`\n- `google.type.DateTime`\n- [google.protobuf.Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)\n\n| JSON representation |\n|---------------------------------------------------------------|\n| ``` { \"year\": integer, \"month\": integer, \"day\": integer } ``` |\n\n| Fields ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `year` | `integer` Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |\n| `month` | `integer` Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |\n| `day` | `integer` Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. |"]]