Description
The dates node contains information on the specific days you want to search. Based on the the fields you include within this node, certain behavior will occur. If a DateRange node is included, the results will use that range from either an EndDate or a StartDate node, with preference to EndDates. If no Start or EndDate node is included, the results will stem from the most current day in the system and go back the range of DateRange. If no DateRange is included, the dates used will be those between StartDate and EndDate. If either one is missing, the API will search only the day that is included. Finally, if only Date nodes exist, the API will search each of the days seperately. If the Dates node is missing entirely, then the most recent system date will be searched. NOTE: Regardless of the date format, you may not search more then 31 days at a time. If your date range or list contains more then 31 days, your call will return an error.
To summarize, the following value combinations are valid:
- EndDate or StartDate nodes on their own - Searches the one day specified.
- EndDate and StartDate nodes - Searches all days from the StartDate to the EndDate.
- EndDate and DateRange nodes - Searches from the EndDate BACK through the DateRange.
- StartDate and DateRange nodes - Searches from the StartDate FORWARD through the DateRange.
- DateRange node on it's own - Searches from the latest system date BACK through the DateRange.
- Date nodes - Searches the specific days specified.
See Also:
StartDate,
EndDate,
DateRange and
DateExample Usage
<Dates>
<StartDate>2006-03-10</StartDate>
<EndDate>2006-03-14</EndDate>
</Dates>
Returns auctions that closed between March 10th and March 14th, 2006.
<Dates>
<StartDate>2006-03-10</StartDate>
<DateRange>SevenDays</DateRange>
</Dates>
Returns listings that closed between March 10th 2006 and seven days later, March 16th.
<Dates>
<DateRange>SevenDays</DateRange>
</Dates>
Searches from the latest system date back 7 days. If the latest system date was March 20th, then the search would cover March 14th to March 20th.
<Dates>
<EndDate>2006-03-10</EndDate>
<DateRange>SevenDays</DateRange>
<Date>2006-03-04</Date>
</Dates>
This is an illegal combination of tags. You may not group a "Date" tag with an "EndDate", "DateRange", or "StartDate" tag.
Always Required/Included
No