1: <?php
 2: /**
 3:  * Calendar interface for events.
 4:  *
 5:  * @package    Elgg.Core
 6:  * @subpackage DataModel.Notable
 7:  *
 8:  * @todo Implement or remove.
 9:  */
10: interface Notable {
11:     /**
12:      * Calendar functionality.
13:      * This function sets the time of an object on a calendar listing.
14:      *
15:      * @param int $hour     If ommitted, now is assumed.
16:      * @param int $minute   If ommitted, now is assumed.
17:      * @param int $second   If ommitted, now is assumed.
18:      * @param int $day      If ommitted, now is assumed.
19:      * @param int $month    If ommitted, now is assumed.
20:      * @param int $year     If ommitted, now is assumed.
21:      * @param int $duration Duration of event, remainder of the day is assumed.
22:      *
23:      * @return bool
24:      */
25:     public function setCalendarTimeAndDuration($hour = NULL, $minute = NULL, $second = NULL,
26:         $day = NULL, $month = NULL, $year = NULL, $duration = NULL);
27: 
28:     /**
29:      * Return the start timestamp.
30:      *
31:      * @return int
32:      */
33:     public function getCalendarStartTime();
34: 
35:     /**
36:      * Return the end timestamp.
37:      *
38:      * @return int
39:      */
40:     public function getCalendarEndTime();
41: }
42: