         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)

        return self.dateIsBetween(date, startDate: beginningOfMonth, endDate: endOfMonth)
    }
    
    public func yearContainsDate(date:NSDate, year:NSDate) -> Bool {
        let beginningOfYear = self.beginningOfYear(year)
        let endOfYear = self.endOfYear(year)

        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)
