This document explains how to specify and interpret time and date ranges in the Monitor Service API. You need to read this if you are using the Methods endpoint.
When specifying timestamp ranges in the Monitor Service API, note that the range is inclusive. In other words, the timestamp includes everything that happened during that interval up to the start of the next interval. Specifying the same start and end time yields a single data point at the requested granularity.
This model offers a consistent application of time and date range specifications that scale from minute to monthly granularity. The following table shows some examples.
|Range (start - end)||Interval/Granularity||Points Returned||Data|
|1:00 - 1:00||1 minute||1||covers 1:00:00 - 1:00:59|
|1:00 - 1:01||1 minute||2||1:00, 1:01 and it covers 1:00:00 - 1:01:59|
|1:00 - 2:00||1 minute||61||includes up to 2:00:59|
|1:07 - 1:12||1 minute||6||1:07 - 1:12:59|
|1:00 - 1:00||5 minutes||1||1:00 - 1:04:59|
|1:05 - 1:10||5 minutes||2||1:05 - 1:14:59|
|1:00 - 2:00||1 hour||2||includes 1:00 - 2:59|
|1/1/2012 - 1/2/2012||1 day||2||1/1 and 1/2|
|1/1/2012 - 12/12/2012||1 month||12||Data that occurred in each month|