This class offers methods for timezone handling. More...

Collaboration diagram for ilTimeZone:

Public Member Functions
	__sleep ()

	__wakeup ()

	getIdentifier ()

	switchTZ ()
	Switch timezone to given timezone. More...

	restoreTZ ()
	Restore default timezone. More...

	validateTZ ()

Static Public Member Functions
static	_getInstance (string $a_tz='')
	get instance by timezone More...

static	_setDefaultTimeZone (string $a_tz)

static	_restoreDefaultTimeZone ()

static	_getDefaultTimeZone ()
	Calculate and set default time zone. More...

static	initDefaultTimeZone (ilIniFile $ini)
	Initialize default timezone from system settings. More...

Data Fields
const	UTC = 'UTC'

Static Public Attributes
static array	$instances = array()

static array	$valid_tz = array()

Static Protected Member Functions
static	_switchTimeZone (string $a_timezone)

Protected Attributes
ilLogger	$log

string	$timezone = "UTC"

Static Protected Attributes
static string	$default_timezone = ''

static string	$current_timezone = ''

static string	$server_timezone = ''

Private Member Functions
	__construct (string $a_timezone)
	Create new timezone object If no timezone is given, the default server timezone is chosen. More...

Detailed Description

This class offers methods for timezone handling.

ilTimeZone::_getDefault tries to "guess" the server timezone in the following manner: 1) PHP >= 5.2.0 use date_default_timezone_get 2) Read ini option date.timezone if available 3) Read environment PHP_TZ 4) Read environment TZ 5) Use date('T') 6) Use UTC

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Definition at line 32 of file class.ilTimeZone.php.

Constructor & Destructor Documentation

◆ __construct()

ilTimeZone::__construct ( string $a_timezone )

private

Create new timezone object If no timezone is given, the default server timezone is chosen.

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

    {
        global $DIC;
 
        $this->log = $DIC->logger()->cal();
 
        if ($a_timezone) {
            $this->timezone = $a_timezone;
        } else {
            $this->timezone = self::_getDefaultTimeZone();
        }
 
        if (!self::$server_timezone) {
            self::$server_timezone = self::_getDefaultTimeZone();
        }
 
        if (!self::$default_timezone) {
            self::_getDefaultTimeZone();
        }
    }

References $DIC, and _getDefaultTimeZone().

Here is the call graph for this function:

Member Function Documentation

◆ __sleep()

ilTimeZone::__sleep ( )

Definition at line 71 of file class.ilTimeZone.php.

    {
        return array('timezone');
    }

◆ __wakeup()

ilTimeZone::__wakeup ( )

Definition at line 76 of file class.ilTimeZone.php.

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

References $DIC.

◆ _getDefaultTimeZone()

static ilTimeZone::_getDefaultTimeZone ( )

static

Calculate and set default time zone.

Definition at line 195 of file class.ilTimeZone.php.

                                                : string
    {
        if (strlen(self::$default_timezone)) {
            return self::$default_timezone;
        }
        // PHP >= 5.2.0
        // php throws a warning date_default_timezone_get relies on os determination. There is no way to check if this could happen.
        if (function_exists('date_default_timezone_get') and $tz = date_default_timezone_get()) {
            return self::$default_timezone = $tz;
        }
        // PHP ini option (PHP >= 5.1.0)
        if ($tz = ini_get('date.timezone')) {
            return self::$default_timezone = $tz;
        }
        // is $_ENV['PHP_TZ'] set ?
        if ($tz = getenv('PHP_TZ')) {
            return self::$default_timezone = $tz;
        }
        // is $_ENV['TZ'] set ?
        if ($tz = getenv('TZ')) {
            return self::$default_timezone = $tz;
        }
        if (strlen($tz = date('T'))) {
            return self::$default_timezone = $tz;
        }
        return self::$default_timezone = self::UTC;
    }

References $default_timezone, and UTC.

Referenced by __construct(), _getInstance(), _setDefaultTimeZone(), initDefaultTimeZone(), ilObjCalendarSettingsGUI\initFormSettings(), and ilCalendarSettings\read().

Here is the caller graph for this function:

◆ _getInstance()

static ilTimeZone::_getInstance ( string $a_tz = '' )

static

get instance by timezone

Exceptions

ilTimeZoneException

Definition at line 91 of file class.ilTimeZone.php.

                                                          : ilTimeZone
    {
        if (!$a_tz) {
            $a_tz = self::_getDefaultTimeZone();
        }
 
        $instance = self::$instances[$a_tz] ?? (self::$instances[$a_tz] = new ilTimeZone($a_tz));
 
        // Validate timezone if it is not validated before
        if (!array_key_exists($instance->getIdentifier(), self::$valid_tz)) {
            if (!$instance->validateTZ()) {
                throw new ilTimeZoneException('Unsupported timezone given.');
            }
            self::$valid_tz[$instance->getIdentifier()] = true;
        }
 
        // now validate timezone setting
        return $instance;
    }

References _getDefaultTimeZone().

Referenced by ilDate\__construct(), ilDateTime\__construct(), ilICalParser\__construct(), ilCalendarRecurrenceCalculator\applyBYMONTHDAYRules(), ilDateTime\get(), ilICalParser\getTZ(), ilDateTime\switchTimeZone(), and ilUserImportParser\verifyPref().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _restoreDefaultTimeZone()

static ilTimeZone::_restoreDefaultTimeZone ( )

static

Definition at line 186 of file class.ilTimeZone.php.

                                                    : void
    {
        self::$default_timezone = self::$server_timezone;
        self::_switchTimeZone(self::$default_timezone);
    }

References $server_timezone, and _switchTimeZone().

Referenced by ilCalendarRecurrenceCalculator\calculateDateList(), and ilCertificateDateHelperTest\tearDown().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _setDefaultTimeZone()

static ilTimeZone::_setDefaultTimeZone ( string $a_tz )

static

Definition at line 177 of file class.ilTimeZone.php.

                                                            : void
    {
        // Save the server timezone, since there is no way to read later.
        if (!self::$server_timezone) {
            self::$server_timezone = self::_getDefaultTimeZone();
        }
        self::$default_timezone = $a_tz;
    }

References _getDefaultTimeZone().

Referenced by ilCalendarRecurrenceCalculator\adjustTimeZones(), and ilCertificateDateHelperTest\setUp().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _switchTimeZone()

static ilTimeZone::_switchTimeZone ( string $a_timezone )

staticprotected

Definition at line 150 of file class.ilTimeZone.php.

                                                                 : bool
    {
        global $DIC;
 
        $logger = $DIC->logger()->cal();
        if (self::$current_timezone == $a_timezone) {
            return true;
        }
 
        // PHP >= 5.2.0
        if (function_exists('date_default_timezone_set')) {
            if (!date_default_timezone_set($a_timezone)) {
                $logger->info('Invalid timezone given. Timezone: ' . $a_timezone);
                throw new ilTimeZoneException('Invalid timezone given');
            }
            #$ilLog->write(__METHOD__.': Switched timezone to: '.$a_timezone);
            self::$current_timezone = $a_timezone;
            return true;
        }
        if (!putenv('TZ=' . $a_timezone)) {
            $logger->warning('Cannot set TZ environment variable. Please register TZ in php.ini (safe_mode_allowed_env_vars). Timezone');
            throw new ilTimeZoneException('Cannot set TZ environment variable.');
        }
        self::$current_timezone = $a_timezone;
        return true;
    }

References $DIC.

Referenced by _restoreDefaultTimeZone(), restoreTZ(), and switchTZ().

Here is the caller graph for this function:

◆ getIdentifier()

ilTimeZone::getIdentifier ( )

Definition at line 82 of file class.ilTimeZone.php.

                                   : string
    {
        return $this->timezone;
    }

References $timezone.

Referenced by ilDateTime\get(), and ilICalParser\switchTZ().

Here is the caller graph for this function:

◆ initDefaultTimeZone()

static ilTimeZone::initDefaultTimeZone ( ilIniFile $ini )

static

Initialize default timezone from system settings.

Definition at line 226 of file class.ilTimeZone.php.

                                                              : string
    {
        $tz = $ini->readVariable('server', 'timezone');
        if (!strlen($tz)) {
            $tz = self::_getDefaultTimeZone();
        }
        if (!strlen($tz)) {
            $tz = 'UTC';
        }
        date_default_timezone_set($tz);
        return $tz;
    }

References $ini, and _getDefaultTimeZone().

Referenced by ilInitialisation\initIliasIniFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ restoreTZ()

ilTimeZone::restoreTZ ( )

Restore default timezone.

Definition at line 129 of file class.ilTimeZone.php.

                               : bool
    {
        try {
            self::_switchTimeZone(self::$default_timezone);
            return true;
        } catch (ilTimeZoneException $e) {
            // Shouldn't happen since this has been checked during initialisation
            $this->log->warning(': Unsupported timezone given: Timzone: ' . $this->timezone);
            return false;
        }
    }

References Vendor\Package\$e, and _switchTimeZone().

Referenced by validateTZ().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ switchTZ()

ilTimeZone::switchTZ ( )

Switch timezone to given timezone.

Definition at line 114 of file class.ilTimeZone.php.

                              : bool
    {
        try {
            self::_switchTimeZone($this->timezone);
            return true;
        } catch (ilTimeZoneException $exc) {
            // Shouldn't happen since this has been checked during initialisation
            $this->log->warning(': Unsupported timezone given: Timzone: ' . $this->timezone);
            return false;
        }
    }

References _switchTimeZone().

Referenced by ilICalParser\switchTZ(), and validateTZ().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ validateTZ()

ilTimeZone::validateTZ ( )

Definition at line 141 of file class.ilTimeZone.php.

                                : bool
    {
        // this is done by switching to the current tz
        if ($this->switchTZ() and $this->restoreTZ()) {
            return true;
        }
        return false;
    }

References restoreTZ(), and switchTZ().

Here is the call graph for this function:

Field Documentation

◆ $current_timezone

string ilTimeZone::$current_timezone = ''

staticprotected

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

◆ $default_timezone

string ilTimeZone::$default_timezone = ''

staticprotected

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

Referenced by _getDefaultTimeZone().

◆ $instances

array ilTimeZone::$instances = array()

static

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

◆ $log

ilLogger ilTimeZone::$log

protected

Definition at line 43 of file class.ilTimeZone.php.

◆ $server_timezone

string ilTimeZone::$server_timezone = ''

staticprotected

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

Referenced by _restoreDefaultTimeZone().

◆ $timezone

string ilTimeZone::$timezone = "UTC"

protected

Definition at line 44 of file class.ilTimeZone.php.

Referenced by getIdentifier().

◆ $valid_tz

array ilTimeZone::$valid_tz = array()

static

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

◆ UTC

const ilTimeZone::UTC = 'UTC'

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

Referenced by ilDate\__construct(), ilObjCourse\__readSettings(), _getDefaultTimeZone(), ilCalendarCategory\add(), ilCalendarExport\addCategories(), ilCalendarRecurrenceCalculator\adjustTimeZones(), ilCalendarUtil\convertDateToUtcDBTimestamp(), ilExportFileInfo\create(), ilCalendarExport\createVEVENT(), ilObjCourse\findCoursesWithNotEnoughMembers(), ilObjGroup\findGroupsWithNotEnoughMembers(), ilCalendarUserSettings\getExportTimeZone(), ilAdvancedMDFieldDefinitionDateTime\getLuceneSearchString(), ilECSTimePlace\getUTBegin(), ilECSTimePlace\getUTEnd(), ilBookingEntry\lookupBookingsForObject(), ilObjectCustomUserFieldHistory\lookupEntriesByObjectId(), ilSCTasks\lookupLastUpdate(), ilObjCourseAccess\lookupPeriodInfo(), ilObjGroupAccess\lookupPeriodInfo(), ILIAS\EmployeeTalk\Talk\Repository\IliasDBEmployeeTalkRepository\parseFromStdClass(), ilExportFileInfo\read(), ilObjGroup\read(), ilObjectCustomUserFieldHistory\read(), ilSCGroup\read(), ilSCTask\read(), ilDateList\removeByDAY(), ilConsultationHourCron\run(), ilCalendarEntry\save(), ilObjectCustomUserFieldHistory\save(), ilECSTimePlace\setBegin(), ilECSTimePlace\setEnd(), ilCalendarRecurrenceExclusion\toICal(), ilCalendarCategory\update(), ilCalendarEntry\update(), ilSCTask\update(), and ilContainerXmlWriter\writeCourseItemInformation().

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

components/ILIAS/Calendar/classes/class.ilTimeZone.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __sleep()

◆ __wakeup()

◆ _getDefaultTimeZone()

◆ _getInstance()

◆ _restoreDefaultTimeZone()

◆ _setDefaultTimeZone()

◆ _switchTimeZone()

◆ getIdentifier()

◆ initDefaultTimeZone()

◆ restoreTZ()

◆ switchTZ()

◆ validateTZ()

Field Documentation

◆ $current_timezone

◆ $default_timezone

◆ $instances

◆ $log

◆ $server_timezone

◆ $timezone

◆ $valid_tz

◆ UTC