Product Documentation

About time and date ranges

Jun 13, 2013

This topic 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