ilDateList Class Reference

List of dates. More...

Inheritance diagram for ilDateList:

Collaboration diagram for ilDateList:

Public Member Functions
	__construct ($a_type)
	Constructor. More...
	rewind ()
	Iterator Rewind. More...
	current ()
	Iterator Current. More...
	key ()
	Iterator key. More...
	next ()
	Iterator next. More...
	valid ()
	Iterator valid. More...
	get ()
	get More...
	getAtPosition ($a_pos)
	get item at specific position More...
	add ($date)
	add a date to the date list More...
	merge (ilDateList $other_list)
	Merge two lists. More...
	remove (ilDateTime $remove)
	remove from list More...
	removeByDAY (ilDateTime $remove)
	sort ()
	Sort list. More...
	__toString ()
	to string More...

Data Fields
const	TYPE_DATE = 1
const	TYPE_DATETIME = 2

Protected Attributes
	$list_item = array()
	$type

Detailed Description

List of dates.

Author

Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version

$Id$

Definition at line 34 of file class.ilDateList.php.

Constructor & Destructor Documentation

__construct()

ilDateList::__construct

(

$a_type

)

Constructor.

public

Parameters

type	list of TYPE_DATE or type TYPE_DATETIME

Definition at line 50 of file class.ilDateList.php.

        {
                $this->type = $a_type;
                $this->list_item = array();
        }

Member Function Documentation

__toString()

ilDateList::__toString

(

)

to string

public

Definition at line 209 of file class.ilDateList.php.

References $out, and IL_CAL_DATETIME.

        {
                $out = '<br />';
                foreach($this->get() as $date)
                {
                        $out .= $date->get(IL_CAL_DATETIME,'','Europe/Berlin').'<br/>';
                }
                return $out;
        }

add()

ilDateList::add

(

$date

)

add a date to the date list

public

Parameters

object

ilDateTime

Definition at line 140 of file class.ilDateList.php.

References IL_CAL_UNIX.

Referenced by merge().

        {
                // the unix time is the key. 
                // It's casted to string because array_merge overwrites only string keys
                // @see merge
                $this->list_item[(string) $date->get(IL_CAL_UNIX)] = clone $date;
        }

Here is the caller graph for this function:

current()

ilDateList::current

(

)

Iterator Current.

Returns

Definition at line 70 of file class.ilDateList.php.

Referenced by valid().

        {
                return current($this->list_item);
        }

Here is the caller graph for this function:

get()

ilDateList::get

(

)

get

public

Definition at line 109 of file class.ilDateList.php.

Referenced by ilCalendarRecurrenceCalculator\applyBYDAYRules(), ilCalendarRecurrenceCalculator\applyBYMONTHDAYRules(), ilCalendarRecurrenceCalculator\applyBYMONTHRules(), ilCalendarRecurrenceCalculator\applyBYSETPOSRules(), ilCalendarRecurrenceCalculator\applyBYWEEKNORules(), ilCalendarRecurrenceCalculator\applyBYYEARDAYRules(), ilCalendarRecurrenceCalculator\applyLimits(), and merge().

        {
                return $this->list_item ? $this->list_item : array();
        }

Here is the caller graph for this function:

getAtPosition()

ilDateList::getAtPosition

(

$a_pos

)

get item at specific position

public

Parameters

int	position (first position is 1)

Definition at line 121 of file class.ilDateList.php.

Referenced by ilCalendarRecurrenceCalculator\applyBYSETPOSRules().

        {
                $counter = 1;
                foreach($this->get() as $item)
                {
                        if($counter++ == $a_pos)
                        {
                                return $item;
                        }
                }
                return null;
        }

Here is the caller graph for this function:

key()

ilDateList::key

(

)

Iterator key.

Returns

Definition at line 79 of file class.ilDateList.php.

        {
                return key($this->list_item);
        }

merge()

ilDateList::merge

(

ilDateList

$other_list

)

Merge two lists.

public

Parameters

object

ilDateList

Definition at line 155 of file class.ilDateList.php.

References add(), and get().

        {
                foreach($other_list->get() as $new_date)
                {
                        $this->add($new_date);
                }
        }

Here is the call graph for this function:

next()

ilDateList::next

(

)

Iterator next.

Returns

Definition at line 88 of file class.ilDateList.php.

        {
                return next($this->list_item);
        }

remove()

ilDateList::remove

(

ilDateTime

$remove

)

remove from list

public

Parameters

object

ilDateTime

Definition at line 170 of file class.ilDateList.php.

References IL_CAL_UNIX.

Referenced by ilCalendarRecurrenceCalculator\applyLimits().

        {
                $unix_remove = $remove->get(IL_CAL_UNIX);
                if(isset($this->list_item[$unix_remove]))
                {
                        unset($this->list_item[$unix_remove]);
                }
                return true;
        }

Here is the caller graph for this function:

removeByDAY()

ilDateList::removeByDAY

(

ilDateTime

$remove

)

Definition at line 180 of file class.ilDateList.php.

References ilDateTime\_equals(), IL_CAL_DAY, and ilTimeZone\UTC.

        {
                foreach($this->list_item as $key => $dt)
                {
                        if(ilDateTime::_equals($remove, $dt, IL_CAL_DAY,ilTimeZone::UTC))
                        {
                                unset($this->list_item[$key]);
                        }
                }
                return true;
        }

Here is the call graph for this function:

rewind()

ilDateList::rewind

(

)

Iterator Rewind.

Returns

Definition at line 61 of file class.ilDateList.php.

        {
                reset($this->list_item);
        }

sort()

ilDateList::sort

(

)

Sort list.

public

Definition at line 198 of file class.ilDateList.php.

Referenced by ilCalendarRecurrenceCalculator\applyBYSETPOSRules(), and ilCalendarRecurrenceCalculator\applyLimits().

        {
                return ksort($this->list_item,SORT_NUMERIC);
        }

Here is the caller graph for this function:

valid()

ilDateList::valid

(

)

Iterator valid.

Returns

Definition at line 97 of file class.ilDateList.php.

References current().

        {
                return $this->current() !== false;
        }

Here is the call graph for this function:

Field Documentation

$list_item

ilDateList::$list_item = array()

protected

Definition at line 39 of file class.ilDateList.php.

$type

ilDateList::$type

protected

Definition at line 41 of file class.ilDateList.php.

TYPE_DATE

const ilDateList::TYPE_DATE = 1

Definition at line 36 of file class.ilDateList.php.

Referenced by ilCalendarUtil\_buildMonthDayList(), ilCalendarUtil\_buildWeekDayList(), and ilCalendarRecurrenceCalculator\initDateList().

TYPE_DATETIME

const ilDateList::TYPE_DATETIME = 2

Definition at line 37 of file class.ilDateList.php.

Referenced by ilConsultationHoursGUI\createAppointments(), and ilCalendarRecurrenceCalculator\initDateList().

---

The documentation for this class was generated from the following file:

• Services/Calendar/classes/class.ilDateList.php