Start and End Date

The start and end dates specify the total period of time for which statistical data is being returned.

This period is then further subdivided into smaller periods according to the granularity specified for the operation (see Granularity). The start and end dates are specified in the <duration > / <endDate and <startDate > elements:

Request:
...
<duration>
   <endDate>2011-08-30T00:00:00.000Z</endDate>
   <startDate>2011-08-27T00:00:00.000Z</startDate>
...

Note that all statistical data is stored internally in one-hour blocks. Therefore, if the start and end dates specified in a request fall inside a one-hour block, they are always rounded to include the entire one-hour block, as follows:

  • startDate is rounded down to the nearest hour boundary
  • endDate is rounded up to the nearest hour boundary

For example, if the following dates are specified:

   <endDate>2011-08-25T08:23:55.829Z</endDate>
   <startDate>2011-08-25T10:45:12.000Z</startDate>

The operation response will include the measures (times or counts) stored in the one-hour blocks after the date/time is rounded. For example: