@classDescription Date and time handling More...

Inheritance diagram for ilDateTime:

Collaboration diagram for ilDateTime:

Public Member Functions
	__construct ($a_date=null, $a_format=0, $a_tz='')
	Create new date object. More...

	__clone ()

	__sleep ()

	__wakeup ()

	isNull ()
	Check if a date is null (Datetime == '0000-00-00 00:00:00', unixtime == 0,...) More...

	switchTimeZone ($a_timezone_identifier='')
	Switch timezone. More...

	getTimeZoneIdentifier ()
	get timezone identifier More...

	increment ($a_type, $a_count=1)
	increment More...

	getUnixTime ()
	get unix time More...

	getUTCOffset ()
	get UTC offset More...

	setDate ($a_date, $a_format)
	Set date. More...

	get ($a_format, $a_format_str='', $a_tz='')
	get formatted date More...

	__toString ()
	to string for date time objects Output is user time zone More...

Static Public Member Functions
static	_before (ilDateTime $start, ilDateTime $end, $a_compare_field='', $a_tz='')
	compare two dates and check start is before end This method does not consider tz offsets. More...

static	_equals (ilDateTime $start, ilDateTime $end, $a_compare_field='', $a_tz='')
	Check if two date are equal. More...

static	_after (ilDateTime $start, ilDateTime $end, $a_compare_field='', $a_tz='')
	compare two dates and check start is after end This method does not consider tz offsets. More...

static	_within (ilDateTime $dt, ilDateTime $start, ilDateTime $end, $a_compare_field='', $a_tz='')
	Check whether an date is within a date duration given by start and end. More...

Data Fields
const	YEAR = 'year'

const	MONTH = 'month'

const	WEEK = 'week'

const	DAY = 'day'

const	HOUR = 'hour'

const	MINUTE = 'minute'

const	SECOND = 'second'

Protected Member Functions
	parsePartsToDate ($a_year, $a_month, $a_day, $a_hour=null, $a_min=null, $a_sec=null, $a_timezone=null)

Protected Attributes
	$log

	$timezone = null

	$default_timezone = null

	$dt_obj

Detailed Description

@classDescription Date and time handling

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

Version: $Id$

Definition at line 33 of file class.ilDateTime.php.

Constructor & Destructor Documentation

◆ __construct()

ilDateTime::__construct	(	$a_date = `null`,
		$a_format = `0`,
		$a_tz = `''`
	)

Create new date object.

@access public

Parameters

mixed	integer string following the format given as the second parameter
int	format of date presentation

throws ilDateTimeException

Definition at line 68 of file class.ilDateTime.php.

    {
        global $DIC;
 
        $this->log = $DIC->logger()->cal();
        
        try {
            $this->timezone = ilTimeZone::_getInstance($a_tz);
            $this->default_timezone = ilTimeZone::_getInstance('');
            
            $this->setDate($a_date, $a_format);
        } catch (ilTimeZoneException $exc) {
            $this->log->warning($exc->getMessage());
            throw new ilDateTimeException('Unsupported timezone given. Timezone: ' . $a_tz);
        }
    }

References $DIC, ilTimeZone\_getInstance(), and setDate().

Here is the call graph for this function:

Member Function Documentation

◆ __clone()

ilDateTime::__clone ( )

Definition at line 85 of file class.ilDateTime.php.

    {
        if ($this->dt_obj) {
            $this->dt_obj = clone $this->dt_obj;
        }
    }

References $dt_obj.

◆ __sleep()

ilDateTime::__sleep ( )

Definition at line 92 of file class.ilDateTime.php.

    {
        return array('timezone', 'default_timezone', 'dt_obj');
    }

◆ __toString()

ilDateTime::__toString ( )

to string for date time objects Output is user time zone

@access public

Parameters

return

Reimplemented in ilDate.

Definition at line 579 of file class.ilDateTime.php.

    {
        return $this->get(IL_CAL_DATETIME) . '<br>';
    }

References IL_CAL_DATETIME.

◆ __wakeup()

ilDateTime::__wakeup ( )

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

    {
        global $DIC;
 
        $this->log = $DIC->logger()->cal();
    }

References $DIC.

◆ _after()

static ilDateTime::_after	(	ilDateTime	$start,
		ilDateTime	$end,
			$a_compare_field = `''`,
			$a_tz = `''`
	)

static

compare two dates and check start is after end This method does not consider tz offsets.

So you have to take care that both dates are defined in the the same timezone

@access public

Parameters

object	ilDateTime
object	ilDateTime
string	field used for comparison. E.g `IL_CAL_YEAR` checks if start is one or more years after than end
string	timezone

Definition at line 227 of file class.ilDateTime.php.

    {
        if ($start->isNull() || $end->isNull()) {
            return false;
        }
        
        switch ($a_compare_field) {
            case IL_CAL_YEAR:
                return $start->get(IL_CAL_FKT_DATE, 'Y', $a_tz) > $end->get(IL_CAL_FKT_DATE, 'Y', $a_tz);
 
            case IL_CAL_MONTH:
                return (int) $start->get(IL_CAL_FKT_DATE, 'Ym', $a_tz) > $end->get(IL_CAL_FKT_DATE, 'Ym', $a_tz);
 
            case IL_CAL_DAY:
                return (int) $start->get(IL_CAL_FKT_DATE, 'Ymd', $a_tz) > $end->get(IL_CAL_FKT_DATE, 'Ymd', $a_tz);
 
            case '':
            default:
                return $start->dt_obj > $end->dt_obj;
            
        }
    }

References get(), IL_CAL_DAY, IL_CAL_FKT_DATE, IL_CAL_MONTH, IL_CAL_YEAR, and isNull().

Referenced by ilObjGroupAccess\_registrationEnabled(), _within(), ilCalendarRecurrenceCalculator\applyDurationPeriod(), ilCalendarRecurrenceCalculator\applyLimits(), ilCalendarRecurrenceCalculator\calculateDateList(), ilDateDurationInputGUI\checkInput(), ilAppointmentPresentationConsultationHoursGUI\collectPropertiesAndActions(), ilCourseRegistrationGUI\fillRegistrationPeriod(), ilGroupRegistrationGUI\fillRegistrationPeriod(), ilConsultationHourBookingTableGUI\fillRow(), ilSessionClassificationPathGUI\findSessionContainerForItem(), ilPageObject\getActive(), ilCalendarAppointmentPanelGUI\getHTML(), ilCalendarAgendaListGUI\getHTML(), ilBookingEntry\isAppointmentBookableForUser(), ilECSCategoryMappingRule\matchesValue(), ilObjGroup\register(), ilObjectActivationGUI\update(), ilCourseContentGUI\updateManagedTimings(), ilCourseContentGUI\updatePersonalTimings(), and ilECSCategoryMappingRule\validate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _before()

static ilDateTime::_before	(	ilDateTime	$start,
		ilDateTime	$end,
			$a_compare_field = `''`,
			$a_tz = `''`
	)

static

compare two dates and check start is before end This method does not consider tz offsets.

So you have to take care that both dates are defined in the the same timezone

@access public

Parameters

object	ilDateTime
object	ilDateTime
string	field used for comparison. E.g `IL_CAL_YEAR` checks if start is one or more years earlier than end
string	timezone

Returns: bool

Definition at line 157 of file class.ilDateTime.php.

    {
        if ($start->isNull() || $end->isNull()) {
            return false;
        }
        
        switch ($a_compare_field) {
            case IL_CAL_YEAR:
                return $start->get(IL_CAL_FKT_DATE, 'Y', $a_tz) < $end->get(IL_CAL_FKT_DATE, 'Y', $a_tz);
                
            case IL_CAL_MONTH:
                return (int) $start->get(IL_CAL_FKT_DATE, 'Ym', $a_tz) < $end->get(IL_CAL_FKT_DATE, 'Ym', $a_tz);
            
            case IL_CAL_DAY:
                return (int) $start->get(IL_CAL_FKT_DATE, 'Ymd', $a_tz) < $end->get(IL_CAL_FKT_DATE, 'Ymd', $a_tz);
 
            case '':
            default:
                return $start->dt_obj < $end->dt_obj;
            
        }
    }

References get(), IL_CAL_DAY, IL_CAL_FKT_DATE, IL_CAL_MONTH, IL_CAL_YEAR, and isNull().

Referenced by ilObjGroupAccess\_registrationEnabled(), _within(), ilMiniCalendarGUI\addMiniMonth(), ilCalendarBlockGUI\addMiniMonth(), ilCalendarRecurrenceCalculator\applyDurationPeriod(), ilCalendarRecurrenceCalculator\applyLimits(), ilCalendarRecurrenceCalculator\calculateDateList(), ilBookingEntry\cancelBooking(), ilCourseRegistrationGUI\fillRegistrationPeriod(), ilGroupRegistrationGUI\fillRegistrationPeriod(), ilECSServerTableGUI\fillRow(), ilPageObject\getActive(), ilConsultationHourUtils\getConsultationHourLinksForRepositoryObject(), ilCalendarAgendaListGUI\getHTML(), ilCalendarBlockGUI\getHTML(), ilExerciseManagementGUI\handleIndividualDeadlineCallsObject(), ilECSTimePlace\loadFromJson(), ilObjCourseAccess\lookupRegistrationInfo(), ilObjGroupAccess\lookupRegistrationInfo(), ilECSCategoryMappingRule\matchesValue(), ilCalendarRecurrenceCalculator\optimizeEndingTime(), ilCalendarRecurrenceCalculator\optimizeStartingTime(), ilUserQuery\query(), ilObjGroup\register(), ilCalendarPresentationGUI\synchroniseExternalCalendars(), and ilCalendarEntry\validate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _equals()

static ilDateTime::_equals	(	ilDateTime	$start,
		ilDateTime	$end,
			$a_compare_field = `''`,
			$a_tz = `''`
	)

static

Check if two date are equal.

@access public

Parameters

object	ilDateTime
object	ilDateTime
string	field used for comparison. E.g `IL_CAL_YEAR` checks if start is the same years than end
string	timzone

Returns: bool

Definition at line 192 of file class.ilDateTime.php.

    {
        if ($start->isNull() || $end->isNull()) {
            return false;
        }
        
        switch ($a_compare_field) {
            case IL_CAL_YEAR:
                return $start->get(IL_CAL_FKT_DATE, 'Y', $a_tz) == $end->get(IL_CAL_FKT_DATE, 'Y', $a_tz);
 
            case IL_CAL_MONTH:
                return (int) $start->get(IL_CAL_FKT_DATE, 'Ym', $a_tz) == $end->get(IL_CAL_FKT_DATE, 'Ym', $a_tz);
 
            case IL_CAL_DAY:
                return (int) $start->get(IL_CAL_FKT_DATE, 'Ymd', $a_tz) == $end->get(IL_CAL_FKT_DATE, 'Ymd', $a_tz);
 
            case '':
            default:
                return $start->dt_obj == $end->dt_obj;
            
        }
    }

References get(), IL_CAL_DAY, IL_CAL_FKT_DATE, IL_CAL_MONTH, IL_CAL_YEAR, and isNull().

Referenced by ilCalendarUtil\_isToday(), _within(), ilMiniCalendarGUI\addMiniMonth(), ilCalendarBlockGUI\addMiniMonth(), ilCalendarRecurrenceCalculator\calculateDateList(), ilCalendarAppointmentGUI\edit(), ilSubItemSelectionTableGUI\fillRow(), ilSessionClassificationPathGUI\findSessionContainerForItem(), ilDatePresentation\formatPeriod(), ilCalendarAgendaListGUI\getHTML(), ilDatePresentation\isToday(), ilDatePresentation\isTomorrow(), ilDatePresentation\isYesterday(), and ilDateList\removeByDAY().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _within()

static ilDateTime::_within	(	ilDateTime	$dt,
		ilDateTime	$start,
		ilDateTime	$end,
			$a_compare_field = `''`,
			$a_tz = `''`
	)

static

Check whether an date is within a date duration given by start and end.

Parameters

ilDateTime	$dt
ilDateTime	$start
ilDateTime	$end
type	$a_compare_field
type	$a_tz

Definition at line 258 of file class.ilDateTime.php.

    {
        return
            (ilDateTime::_after($dt, $start, $a_compare_field, $a_tz) or ilDateTime::_equals($dt, $start, $a_compare_field, $a_tz)) &&
            (ilDateTime::_before($dt, $end, $a_compare_field, $a_tz) or ilDateTime::_equals($dt, $end, $a_compare_field, $a_tz));
    }

References _after(), _before(), and _equals().

Referenced by ilCalendarScheduleFilterTimings\addCustomEvents(), ilCalendarScheduleFilterExercise\addCustomEvents(), and ilCalendarHeaderNavigationGUI\getHTML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get()

ilDateTime::get	(	$a_format,
		$a_format_str = `''`,
		$a_tz = `''`
	)

get formatted date

@access public

Parameters

int	format type
string	format string
string	a specific timezone

Returns: string|int

Reimplemented in ilDate.

Definition at line 506 of file class.ilDateTime.php.

    {
        if ($this->isNull()) {
            return;
        }
            
        if ($a_tz) {
            try {
                $timezone = ilTimeZone::_getInstance($a_tz);
            } catch (ilTimeZoneException $exc) {
                $this->log->warning('Invalid timezone given. Timezone: ' . $a_tz);
            }
        } else {
            $timezone = $this->default_timezone;
        }
            
        $out_date = clone($this->dt_obj);
        $out_date->setTimezone(new DateTimeZone($timezone->getIdentifier()));
 
        switch ($a_format) {
            case IL_CAL_UNIX:
                // timezone unrelated
                $date = $this->getUnixTime();
                break;
            
            case IL_CAL_DATE:
                $date = $out_date->format('Y-m-d');
                break;
            
            case IL_CAL_DATETIME:
                $date = $out_date->format('Y-m-d H:i:s');
                break;
            
            case IL_CAL_FKT_DATE:
                $date = $out_date->format($a_format_str);
                break;
                
            case IL_CAL_FKT_GETDATE:
                $date = array(
                    'seconds' => (int) $out_date->format('s')
                    ,'minutes' => (int) $out_date->format('i')
                    ,'hours' => (int) $out_date->format('G')
                    ,'mday' => (int) $out_date->format('j')
                    ,'wday' => (int) $out_date->format('w')
                    ,'mon' => (int) $out_date->format('n')
                    ,'year' => (int) $out_date->format('Y')
                    ,'yday' => (int) $out_date->format('z')
                    ,'weekday' => $out_date->format('l')
                    ,'month' => $out_date->format('F')
                    ,'isoday' => (int) $out_date->format('N')
                );
                break;
            
            case IL_CAL_ISO_8601:
                $date = $out_date->format('c');
                break;
                
            case IL_CAL_TIMESTAMP:
                $date = $out_date->format('YmdHis');
                break;
        }
        
        return $date;
    }

References $default_timezone, $timezone, ilTimeZone\_getInstance(), getUnixTime(), IL_CAL_DATE, IL_CAL_DATETIME, IL_CAL_FKT_DATE, IL_CAL_FKT_GETDATE, IL_CAL_ISO_8601, IL_CAL_TIMESTAMP, IL_CAL_UNIX, and isNull().

Referenced by _after(), _before(), _equals(), ilConsultationHourUtils\findCalendarAppointmentsForBooking(), ilDatePresentation\formatDate(), ilDatePresentation\formatPeriod(), ilCmiXapiDateTime\fromIliasDateTime(), ilCalendarRegistration\getRegisteredUsers(), ilCalendarRecurrenceCalculator\getYearWeekDays(), ilCalendarRegistration\isRegistered(), ilLTIDataConnector\lookupResourcesForAllUsersSinceDate(), ilUtil\period2String(), ilExcel\prepareDateValue(), ilExAssignment\setIndividualDeadline(), ilCalendarRegistration\unregister(), and ilCmiXapiUser\updateFetchedUntilForObjects().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTimeZoneIdentifier()

ilDateTime::getTimeZoneIdentifier ( )

get timezone identifier

@access public

Definition at line 138 of file class.ilDateTime.php.

    {
        return $this->timezone->getIdentifier();
    }

Referenced by parsePartsToDate(), and setDate().

Here is the caller graph for this function:

◆ getUnixTime()

ilDateTime::getUnixTime ( )

get unix time

@access public

Definition at line 329 of file class.ilDateTime.php.

    {
        if (!$this->isNull()) {
            return $this->dt_obj->getTimestamp();
        }
    }

References isNull().

Referenced by get(), and increment().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUTCOffset()

ilDateTime::getUTCOffset ( )

get UTC offset

@access public

Returns: offset to utc in seconds

Definition at line 342 of file class.ilDateTime.php.

    {
        if (!$this->isNull()) {
            // already correct/current timezone?
            $offset = $this->dt_obj->getOffset();
 
            // TODO: This is wrong: calculate UTC offset of given date
            // $offset = mktime(0,0,0,2,1,1970) - gmmktime(0,0,0,2,1,1970);
        }
        return $offset;
    }

References isNull().

Here is the call graph for this function:

◆ increment()

ilDateTime::increment	(	$a_type,
		$a_count = `1`
	)

increment

@access public

Parameters

int	type
int	count

Definition at line 273 of file class.ilDateTime.php.

    {
        if ($this->isNull()) {
            return;
        }
        
        $sub = ($a_count < 0);
        $count_str = abs($a_count);
        
        switch ($a_type) {
            case self::YEAR:
                $count_str .= 'year';
                break;
 
            case self::MONTH:
                $count_str .= 'month';
                break;
                
            case self::WEEK:
                $count_str .= 'week';
                break;
                
            case self::DAY:
                $count_str .= 'day';
                break;
                
            case self::HOUR:
                $count_str .= 'hour';
                break;
                
            case self::MINUTE:
                $count_str .= 'minute';
                break;
 
            case self::SECOND:
                $count_str .= 'second';
                break;
        }
        
        $interval = date_interval_create_from_date_string($count_str);
        if (!$sub) {
            $this->dt_obj->add($interval);
        } else {
            $this->dt_obj->sub($interval);
        }
        
        // ???
        return $this->getUnixTime();
    }

References DAY, getUnixTime(), HOUR, isNull(), MINUTE, MONTH, SECOND, WEEK, and YEAR.

Referenced by ilTimingsUser\handleNewMembership(), and ilCalendarSchedule\initPeriod().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isNull()

ilDateTime::isNull ( )

Check if a date is null (Datetime == '0000-00-00 00:00:00', unixtime == 0,...)

Returns: bool

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

    {
        return !($this->dt_obj instanceof DateTime);
    }

Referenced by _after(), _before(), _equals(), ilDatePresentation\formatDate(), get(), getUnixTime(), getUTCOffset(), increment(), ilObjCourseGUI\infoScreen(), and ilObjGroupGUI\infoScreen().

Here is the caller graph for this function:

◆ parsePartsToDate()

ilDateTime::parsePartsToDate	(	$a_year,
		$a_month,
		$a_day,
		$a_hour = `null`,
		$a_min = `null`,
		$a_sec = `null`,
		$a_timezone = `null`
	)

protected

Definition at line 354 of file class.ilDateTime.php.

    {
        $a_year = (int) $a_year;
        $a_month = (int) $a_month;
        $a_day = (int) $a_day;
        
        if (!$a_year) {
            return;
        }
        
        try {
            $a_hour = (int) $a_hour;
            $a_min = (int) $a_min;
            $a_sec = (int) $a_sec;
            
            $format = $a_year . '-' . $a_month . '-' . $a_day;
                                
            if ($a_hour !== null) {
                $format .= ' ' . (int) $a_hour . ':' . (int) $a_min . ':' . (int) $a_sec;
                
                // use current timezone if no other given
                if (!$a_timezone) {
                    $a_timezone = $this->getTimeZoneIdentifier();
                }
 
                $date = new DateTime($format, new DateTimeZone($a_timezone));
            } else {
                $date = new DateTime($format);
            }
        } catch (Exception $ex) {
            // :TODO: do anything?
        }
        return ($date instanceof DateTime)
            ? $date
            : null;
    }

References $format, and getTimeZoneIdentifier().

Referenced by setDate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDate()

ilDateTime::setDate	(	$a_date,
		$a_format
	)

Set date.

@access public

Parameters

mixed	date
int	format

Exceptions

ilDateTimeException

Definition at line 401 of file class.ilDateTime.php.

    {
        $this->dt_obj = null;
        
        if (!$a_date) {
            return;
        }
        
        switch ($a_format) {
            case IL_CAL_UNIX:
                try {
                    $this->dt_obj = new DateTime('@' . $a_date);
                    $this->dt_obj->setTimezone(new DateTimeZone($this->getTimeZoneIdentifier()));
                } catch (Exception $ex) {
                    $message = 'Cannot parse date: ' . $a_date . ' with format ' . $a_format;
                    $this->log->warning($message);
                    throw new ilDateTimeException($message);
                }
                break;
                
            case IL_CAL_DATETIME:
                $matches = preg_match('/^(\d{4})-?(\d{2})-?(\d{2})([T\s]?(\d{2}):?(\d{2}):?(\d{2})(\.\d+)?(Z|[\+\-]\d{2}:?\d{2})?)$/i', $a_date, $d_parts);
                if ($matches < 1) {
                    $this->log->warning('Cannot parse date: ' . $a_date);
                    $this->log->warning(print_r($matches, true));
                    $this->log->logStack(ilLogLevel::WARNING);
                    throw new ilDateTimeException('Cannot parse date: ' . $a_date);
                }
                
                $tz_id = ($d_parts[9] == 'Z')
                    ? 'UTC'
                    : $this->getTimeZoneIdentifier();
                $this->dt_obj = $this->parsePartsToDate(
                    $d_parts[1],
                    $d_parts[2],
                    $d_parts[3],
                    $d_parts[5],
                    $d_parts[6],
                    $d_parts[7],
                    $tz_id
                );
                break;
 
            case IL_CAL_DATE:
                try {
                    // Pure dates are not timezone sensible.
                    $this->dt_obj = new DateTime($a_date, new DateTimeZone('UTC'));
                } catch (Exception $ex) {
                    $this->log->warning('Cannot parse date : ' . $a_date);
                    throw new ilDateTimeException('Cannot parse date: ' . $a_date);
                }
                break;
                
            case IL_CAL_FKT_GETDATE:
                // Format like getdate parameters
                $this->dt_obj = $this->parsePartsToDate(
                    $a_date['year'],
                    $a_date['mon'],
                    $a_date['mday'],
                    $a_date['hours'],
                    $a_date['minutes'],
                    $a_date['seconds'],
                    $this->getTimeZoneIdentifier()
                );
                break;
                
            case IL_CAL_TIMESTAMP:
                if (preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $a_date, $d_parts) == false) {
                    $this->log->warning('Cannot parse date: ' . $a_date);
                    throw new ilDateTimeException('Cannot parse date.');
                }
                $this->dt_obj = $this->parsePartsToDate(
                    $d_parts[1],
                    $d_parts[2],
                    $d_parts[3],
                    $d_parts[4],
                    $d_parts[5],
                    $d_parts[6],
                    $this->getTimeZoneIdentifier()
                );
                break;
                
            case IL_CAL_ISO_8601:
                $this->dt_obj = DateTime::createFromFormat(
                    DateTime::ISO8601,
                    $a_date,
                    new DateTimeZone($this->getTimeZoneIdentifier())
                    );
                break;
        }
 
        // remove set timezone since it does not influence the internal date.
        // the tz must be passed in the moment of the creation of the date object.
        return true;
    }

References $message, getTimeZoneIdentifier(), IL_CAL_DATE, IL_CAL_DATETIME, IL_CAL_FKT_GETDATE, IL_CAL_ISO_8601, IL_CAL_TIMESTAMP, IL_CAL_UNIX, parsePartsToDate(), and ilLogLevel\WARNING.

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ switchTimeZone()

ilDateTime::switchTimeZone ( $a_timezone_identifier = '' )

Switch timezone.

@access public

Parameters

string PHP timezone identifier

Exceptions

ilDateTimeException

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

    {
        try {
            $this->timezone = ilTimeZone::_getInstance($a_timezone_identifier);
            return true;
        } catch (ilTimeZoneException $e) {
            $this->log->warning('Unsupported timezone given: ' . $a_timezone_identifier);
            throw new ilDateTimeException('Unsupported timezone given. Timezone: ' . $a_timezone_identifier);
        }
    }

References Vendor\Package\$e, and ilTimeZone\_getInstance().

Referenced by ilCalendarRecurrenceCalculator\adjustTimeZones().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $default_timezone

ilDateTime::$default_timezone = null

protected

Definition at line 49 of file class.ilDateTime.php.

Referenced by get().

◆ $dt_obj

ilDateTime::$dt_obj

protected

Definition at line 54 of file class.ilDateTime.php.

Referenced by __clone().

◆ $log

ilDateTime::$log

protected

Definition at line 46 of file class.ilDateTime.php.

◆ $timezone

ilDateTime::$timezone = null

protected

Definition at line 48 of file class.ilDateTime.php.

Referenced by get().

◆ DAY

const ilDateTime::DAY = 'day'

Definition at line 38 of file class.ilDateTime.php.

Referenced by ilCalendarRecurrenceCalculator\applyBYMONTHDAYRules(), ilCalendarRecurrenceCalculator\applyBYYEARDAYRules(), ilCalendarSchedule\getByDay(), ilCalendarAgendaListGUI\getHTML(), ilCalendarHeaderNavigationGUI\getHTML(), increment(), ilCalendarRecurrenceCalculator\incrementByFrequency(), ilBookingReservationsTableGUI\initFilter(), ilCalendarRecurrenceCalculator\optimizeEndingTime(), and ilLoggerCronCleanErrorFiles\run().

◆ HOUR

const ilDateTime::HOUR = 'hour'

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

Referenced by ilConsultationHoursGUI\createAppointments(), and increment().

◆ MINUTE

const ilDateTime::MINUTE = 'minute'

Definition at line 40 of file class.ilDateTime.php.

Referenced by ilCalendarRecurrenceCalculator\applyDurationPeriod(), ilConsultationHoursGUI\createAppointments(), and increment().

◆ MONTH

const ilDateTime::MONTH = 'month'

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

Referenced by ilMiniCalendarGUI\addMiniMonth(), ilCalendarRecurrenceCalculator\applyBYMONTHRules(), ilCalendarHeaderNavigationGUI\getHTML(), ilCalendarBlockGUI\getViewControl(), increment(), ilCalendarRecurrenceCalculator\incrementByFrequency(), and ilCalendarHeaderNavigationGUI\incrementDate().

◆ SECOND

const ilDateTime::SECOND = 'second'

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

Referenced by increment().

◆ WEEK

const ilDateTime::WEEK = 'week'

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

Referenced by ilCalendarRecurrenceCalculator\applyBYWEEKNORules(), ilCalendarHeaderNavigationGUI\getHTML(), increment(), ilCalendarRecurrenceCalculator\incrementByFrequency(), and ilCalendarWeekGUI\show().

◆ YEAR

const ilDateTime::YEAR = 'year'

Definition at line 35 of file class.ilDateTime.php.

Referenced by ilConsultationHoursGUI\createAppointments(), increment(), and ilCalendarRecurrenceCalculator\incrementByFrequency().

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

Services/Calendar/classes/class.ilDateTime.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __clone()

◆ __sleep()

◆ __toString()

◆ __wakeup()

◆ _after()

◆ _before()

◆ _equals()

◆ _within()

◆ get()

◆ getTimeZoneIdentifier()

◆ getUnixTime()

◆ getUTCOffset()

◆ increment()

◆ isNull()

◆ parsePartsToDate()

◆ setDate()

◆ switchTimeZone()

Field Documentation

◆ $default_timezone

◆ $dt_obj

◆ $log

◆ $timezone

◆ DAY

◆ HOUR

◆ MINUTE

◆ MONTH

◆ SECOND

◆ WEEK

◆ YEAR