Editing IRStats Technical Documentation (section)

== Periods ==
The Periods object is used when you want to break a daterange down into sub-ranges.  Used with the params->mask() function, stats can be retrieved for periods inside a date range.
===Functions===
*new(start_date_obj, end_date_obj) - doesn't do anything, just returns the object.

The following functions all return an array of hashes.  Each hash has the keys 'start_date' and 'end_date', and the values are both IRStats::Date objects.

*calandar_months - Returns full months (each element starts on the 1st, and ends on the last day).
*months - Returns month periods (if the start_date is the 15th, then each period starts on the 15th and ends on the 14th of the next month - except the last period, which only has about a 1/30 chance of doing so).
*weeks - returns 7-day periods (except the last, which has a 1/7 chance of being 7 days long).
*days - returns single days (for each period, the start_date and end_date are the same).