         return !beforeStartDate && !afterEndDate
     }
     
+    /**
+        Returns true if the given date falls within the hour of the given hour
+        or false otherwise.
+    
+        :param: date The date being tested
+        :param: hour Any date within the hour of the test range
+    
+        :returns: True if the given date falls within the hour or false otherwise
+    */
     public func hourContainsDate(date:NSDate, hour:NSDate) -> Bool {
         let beginningOfHour = self.beginningOfHour(hour)
         let endOfHour = self.endOfHour(hour)

        return self.timeUnits(.CalendarUnitMonth, fromDate: firstMonthOfYear, toDate: firstMonthOfNextYear)
    }
    
// MARK: - Determining whether date falls within time unit
    private func dateIsBetween(date:NSDate, startDate:NSDate, endDate:NSDate) -> Bool {
        let beforeStartDate = startDate.compare(date) == .OrderedDescending
        let afterEndDate = endDate.compare(date) == .OrderedAscending

        return self.dateIsBetween(date, startDate: beginningOfHour, endDate: endOfHour)
    }
    
    /**
        Returns true if the given date falls within the day of the given day or
        false otherwise. See also NSCalendar.isDate:inSameDayAsDate method for 
        similar functionality.
    
        :param: date The date being tested.
        :param: day  Any date within the day of the test range.
    
        :returns: True if the given date falls wtihin the day or false otherwise.
    */
    public func dayContainsDate(date:NSDate, day:NSDate) -> Bool {
        let beginningOfDay = self.beginningOfDay(day)
        let endOfDay = self.endOfDay(day)
