type DateTimeRange (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Represents a range of dates (combined with time of day) that has an upper and/or lower bound.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
startDateTime
|
DateTime
The start date time of this range. This field is optional and if it is not set then there is no
lower bound on the date time range. If this field is not set then endDateTime must be
specified.
|
endDateTime
|
DateTime
The end date time of this range. This field is optional and if it is not set then there is no
upper bound on the date time range. If this field is not set then startDateTime must be
specified.
|
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-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eDateTimeRange in Google Ad Manager represents a period with a start and/or end date and time.\u003c/p\u003e\n"],["\u003cp\u003eIt's used by various services like ProposalLineItemService, ForecastService, and TargetingPresetService to define time boundaries.\u003c/p\u003e\n"],["\u003cp\u003eDateTimeRange can have either a start, an end, or both, allowing for open-ended or specific timeframes.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estartDateTime\u003c/code\u003e and \u003ccode\u003eendDateTime\u003c/code\u003e fields, if set, specify the lower and upper limits of the range, respectively.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes the DateTime object for precise time representation within the range.\u003c/p\u003e\n"]]],["The content outlines the `DateTimeRange` data structure used across multiple services within the Ad Manager API v202408. This structure represents a date and time range with optional start and end boundaries. Services using this include AdRule, Adjustment, Forecast, LineItem, NativeStyle, ProposalLineItem, Proposal, PublisherQueryLanguage, TargetingPreset, and YieldGroup. The `DateTimeRange` includes `startDateTime` and `endDateTime` fields, which, if one isn't set, the other must be.\n"],null,["# type DateTimeRange (v202408)\n\n**Service** \n[AdRuleService](/ad-manager/api/reference/v202408/AdRuleService.DateTimeRange) [AdjustmentService](/ad-manager/api/reference/v202408/AdjustmentService.DateTimeRange) [ForecastService](/ad-manager/api/reference/v202408/ForecastService.DateTimeRange) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.DateTimeRange) [NativeStyleService](/ad-manager/api/reference/v202408/NativeStyleService.DateTimeRange) **ProposalLineItemService** [ProposalService](/ad-manager/api/reference/v202408/ProposalService.DateTimeRange) [PublisherQueryLanguageService](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.DateTimeRange) [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.DateTimeRange) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.DateTimeRange) **Dependencies** \n[DateTimeRangeTargeting](/ad-manager/api/reference/v202408/ProposalLineItemService.DateTimeRangeTargeting) \n▼\n**DateTimeRange**\n\nRepresents a range of dates (combined with time of day) that has an upper and/or lower bound.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `startDateTime` | ` `[DateTime](/ad-manager/api/reference/v202408/ProposalLineItemService.DateTime)` ` The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then `endDateTime` must be specified. |\n| ### `endDateTime` | ` `[DateTime](/ad-manager/api/reference/v202408/ProposalLineItemService.DateTime)` ` The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then `startDateTime` must be specified. |"]]