<?php /** * VEvent component * * This component contains some additional functionality specific for VEVENT's. * * @package Sabre * @subpackage VObject * @copyright Copyright (C) 2007-2012 Rooftop Solutions. All rights reserved. * @author Evert Pot (http://www.rooftopsolutions.nl/) * @license http://code.google.com/p/sabredav/wiki/License Modified BSD License */ class Sabre_VObject_Component_VEvent extends Sabre_VObject_Component { /** * Returns true or false depending on if the event falls in the specified * time-range. This is used for filtering purposes. * * The rules used to determine if an event falls within the specified * time-range is based on the CalDAV specification. * * @param DateTime $start * @param DateTime $end * @return bool */ public function isInTimeRange(DateTime $start, DateTime $end) { if ($this->RRULE) { $it = new Sabre_VObject_RecurrenceIterator($this); $it->fastForward($start); // We fast-forwarded to a spot where the end-time of the // recurrence instance exceeded the start of the requested // time-range. // // If the starttime of the recurrence did not exceed the // end of the time range as well, we have a match. return ($it->getDTStart() < $end && $it->getDTEnd() > $start); } $effectiveStart = $this->DTSTART->getDateTime(); if (isset($this->DTEND)) { $effectiveEnd = $this->DTEND->getDateTime(); // If this was an all-day event, we should just increase the // end-date by 1. Otherwise the event will last until the second // the date changed, by increasing this by 1 day the event lasts // all of the last day as well. if ($this->DTSTART->getDateType() == Sabre_VObject_Property_DateTime::DATE) { $effectiveEnd->modify('+1 day'); } } elseif (isset($this->DURATION)) { $effectiveEnd = clone $effectiveStart; $effectiveEnd->add( Sabre_VObject_DateTimeParser::parseDuration($this->DURATION) ); } elseif ($this->DTSTART->getDateType() == Sabre_VObject_Property_DateTime::DATE) { $effectiveEnd = clone $effectiveStart; $effectiveEnd->modify('+1 day'); } else { $effectiveEnd = clone $effectiveStart; } return ( ($start <= $effectiveEnd) && ($end > $effectiveStart) ); } }