This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilCalendarUtil:

Static Public Member Functions
static	convertDateToUtcDBTimestamp (?\ilDateTime $date=null)

static	_isToday (ilDateTime $date)

static	_numericMonthToString (int $a_month, bool $a_long=true, ?ilLanguage $lng=null)
	numeric month to string More...

static	_numericDayToString (int $a_day, bool $a_long=true, ?ilLanguage $lng=null)

static	_buildWeekDayList (ilDate $a_day, int $a_weekstart)
	build week day list public More...

static	_buildMonthDayList (int $a_month, int $a_year, int $weekstart)
	Build a month day list. More...

static	initJSCalendar ()

static	getZoneInfoFile ($a_tz)

static	_getShortTimeZoneList ()
	get short timezone list More...

static	_isLeapYear (int $a_year)
	check if a given year is a leap year More...

static	_getMaxDayOfMonth (int $a_year, int $a_month)
	get max day of month 2008,2 => 29 More...

static	calculateFontColor (string $a_html_color_code)
	Calculate best font color from html hex color code. More...

static	getHourSelection (int $a_format)
	Get hour selection depending on user specific hour format. More...

static	initDefaultCalendarByType (int $a_type_id, int $a_usr_id, string $a_title, bool $a_create=false)
	Init the default calendar for given type and user. More...

static	getUserDateFormat (int $a_add_time=0, bool $a_for_parsing=false)
	Parse current user setting into date/time format. More...

static	initDateTimePicker ()

static	parseDateString (string $date, bool $add_time=false, ?string $force_format=null)
	Parse (incoming) string to date/time object. More...

static	parseIncomingDate ($value, bool $add_time=false)
	Try to parse incoming value to date object. More...

Static Public Attributes
static string	$init_done

Static Protected Attributes
static bool	$init_datetimepicker = false

Static Private Attributes
static ilDateTime	$today = null

static array	$default_calendar = array()

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilCalendarUtil

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Definition at line 23 of file class.ilCalendarUtil.php.

Member Function Documentation

◆ _buildMonthDayList()

static ilCalendarUtil::_buildMonthDayList	(	int	$a_month,
		int	$a_year,
		int	$weekstart
	)

static

Build a month day list.

Parameters

int	month
int	year
int	weekstart (0 => Sunday,1 => Monday)

Returns: ilDateList

Definition at line 118 of file class.ilCalendarUtil.php.

References IL_CAL_FKT_DATE, IL_CAL_FKT_GETDATE, IL_CAL_UNIX, and ilDateList\TYPE_DATE.

Referenced by ilMiniCalendarGUI\addMiniMonth(), ilCalendarBlockGUI\addMiniMonth(), and ilCalendarMonthGUI\show().

                                                                                         : ilDateList
     {
         $day_list = new ilDateList(ilDateList::TYPE_DATE);
 
         $prev_month = ($a_month == 1) ? 12 : $a_month - 1;
         $prev_year = ($prev_month == 12) ? $a_year - 1 : $a_year;
         $next_month = $a_month == 12 ? 1 : $a_month + 1;
         $next_year = $a_month == 12 ? $a_year + 1 : $a_year;
 
         $days_in_month = self::_getMaxDayOfMonth($a_year, $a_month);
         $days_in_prev_month = self::_getMaxDayOfMonth($a_year, $prev_month);
 
         $week_day['year'] = $a_year;
         $week_day['mon'] = $a_month;
         $week_day['mday'] = 1;
         $week_day['hours'] = 0;
         $week_day['minutes'] = 0;
         $week_day = new ilDate($week_day, IL_CAL_FKT_GETDATE);
 
         $weekday = $week_day->get(IL_CAL_FKT_DATE, 'w');
         $first_day_offset = (($weekday - $weekstart) < 0) ? 6 : $weekday - $weekstart;
 
         for ($i = 0; $i < 42; $i++) {
             if ($i < $first_day_offset) {
                 $day = $days_in_prev_month - $first_day_offset + $i + 1;
 
                 $day_list->add(new ilDate(
                     gmmktime(
                         0,
                         0,
                         0,
                         $prev_month,
                         $days_in_prev_month - $first_day_offset + $i + 1,
                         $prev_year
                     ),
                     IL_CAL_UNIX
                 ));
             } elseif ($i < $days_in_month + $first_day_offset) {
                 $day = $i - $first_day_offset + 1;
 
                 $day_list->add(new ilDate(
                     gmmktime(
                         0,
                         0,
                         0,
                         $a_month,
                         $i - $first_day_offset + 1,
                         $a_year
                     ),
                     IL_CAL_UNIX
                 ));
             } else {
                 $day = $i - $days_in_month - $first_day_offset + 1;
                 $day_list->add(new ilDate(
                     gmmktime(
                         0,
                         0,
                         0,
                         $next_month,
                         $i - $days_in_month - $first_day_offset + 1,
                         $next_year
                     ),
                     IL_CAL_UNIX
                 ));
             }
             if ($i == 34 and ($day < 15 or $day == $days_in_month)) {
                 break;
             }
         }
         return $day_list;
     }

Here is the caller graph for this function:

◆ _buildWeekDayList()

static ilCalendarUtil::_buildWeekDayList	(	ilDate	$a_day,
		int	$a_weekstart
	)

static

build week day list public

Parameters

ilDate	a day in a week
int	weekstart

Returns: ilDateList

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

References ilDate\get(), IL_CAL_DAY, IL_CAL_FKT_GETDATE, and ilDateList\TYPE_DATE.

Referenced by ilCalendarViewGUI\getBucketTitle(), ILIAS\BookingManager\BookingProcess\WeekGridGUI\getHoursOfDay(), ilCalendarHeaderNavigationGUI\getHTML(), ILIAS\BookingManager\BookingProcess\WeekGUI\getHTML(), and ilCalendarWeekGUI\show().

                                                                              : ilDateList
     {
         $day_list = new ilDateList(ilDateList::TYPE_DATE);
 
         $start = clone $a_day;
         $start_info = $start->get(IL_CAL_FKT_GETDATE, '', 'UTC');
         $day_diff = $a_weekstart - $start_info['isoday'];
         if (abs($day_diff) === 7) {
             $day_diff = 0;
         }
         $start->increment(IL_CAL_DAY, $day_diff);
         $day_list->add($start);
         for ($i = 1; $i < 7; $i++) {
             $start->increment(IL_CAL_DAY, 1);
             $day_list->add($start);
         }
         return $day_list;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getMaxDayOfMonth()

static ilCalendarUtil::_getMaxDayOfMonth	(	int	$a_year,
		int	$a_month
	)

static

get max day of month 2008,2 => 29

Definition at line 385 of file class.ilCalendarUtil.php.

Referenced by ilCalendarRecurrenceCalculator\applyBYMONTHDAYRules(), ilCalendarRecurrenceCalculator\getMonthWeekDays(), and ilCalendarSchedule\initPeriod().

                                                                        : int
     {
         if (function_exists('cal_days_in_month')) {
             return cal_days_in_month(CAL_GREGORIAN, $a_month, $a_year);
         }
         return (int) date('t', mktime(0, 0, 0, $a_month, 1, $a_year));
     }

Here is the caller graph for this function:

◆ _getShortTimeZoneList()

static ilCalendarUtil::_getShortTimeZoneList ( )

static

get short timezone list

Definition at line 288 of file class.ilCalendarUtil.php.

Referenced by ilObjCalendarSettingsGUI\initFormSettings(), ilPersonalSettingsGUI\initGeneralSettingsForm(), and ilCalendarUserSettingsGUI\initSettingsForm().

                                                   : array
     {
         return array(
             'Pacific/Samoa' => 'GMT-11: Midway Islands, Samoa',
             'US/Hawaii' => 'GMT-10:00: Hawaii, Polynesia',
             'US/Alaska' => 'GMT-9:00: Alaska',
             'America/Los_Angeles' => 'GMT-8:00: Tijuana, Los Angeles, Seattle, Vancouver',
             'US/Arizona' => 'GMT-7:00: Arizona',
             'America/Chihuahua' => 'GMT-7:00: Chihuahua, La Paz, Mazatlan',
             'America/Denver' => 'GMT-7:00: Arizona, Denver, Salt Lake City, Calgary',
             'America/Chicago' => 'GMT-6:00: Chicago, Dallas, Kansas City, Winnipeg',
             'America/Monterrey' => 'GMT-6:00: Guadalajara, Mexico City, Monterrey',
             'Canada/Saskatchewan' => 'GMT-6:00: Saskatchewan',
             'US/Central' => 'GMT-6:00: Central America',
             'America/Bogota' => 'GMT-5:00: Bogota, Lima, Quito',
             'US/East-Indiana' => 'GMT-5:00: East-Indiana',
             'America/New_York' => 'GMT-5:00: New York, Miami, Atlanta, Detroit, Toronto',
             'Canada/Atlantic' => 'GMT-4:00: Atlantic (Canada)',
             'America/La_Paz' => 'GMT-4:00: Carcas, La Paz',
             'America/Santiago' => 'GMT-4:00: Santiago',
             'Canada/Newfoundland' => 'GMT-3:00: Newfoundland',
             'Brazil/East' => 'GMT-3:00: Sao Paulo',
             'America/Argentina/Buenos_Aires' => 'GMT-3:00: Buenes Aires, Georgtown',
             'Etc/GMT+3' => 'GMT-3:00: Greenland, Uruguay, Surinam',
             'Atlantic/Cape_Verde' => 'GMT-2:00: Cape Verde, Greenland, South Georgia',
             'Atlantic/Azores' => 'GMT-1:00: Azores',
             'Africa/Casablanca' => 'GMT+0:00: Casablanca, Monrovia',
             'Europe/London' => 'GMT+0:00: Dublin, Edinburgh, Lisbon, London',
             'Europe/Berlin' => 'GMT+1:00: Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna',
             'Europe/Belgrade' => 'GMT+1:00: Belgrade, Bratislava, Budapest, Ljubljana, Prague',
             'Europe/Paris' => 'GMT+1:00: Brussels, Copenhagen, Paris, Madrid',
             'Europe/Sarajevo' => 'GMT+1:00: Sarajevo, Skopje, Warsaw, Zagreb',
             'Africa/Lagos' => 'GMT+1:00: West-Central Africa',
             'Europe/Athens' => 'GMT+2:00: Athens, Beirut, Istanbul, Minsk',
             'Europe/Bucharest' => 'GMT+2:00: Bucharest',
             'Africa/Harare' => 'GMT+2:00: Harare, Pratoria',
             'Europe/Helsinki' => 'GMT+2:00: Helsinki, Kiev, Riga, Sofia, Tallinn, Vilnius',
             'Asia/Jerusalem' => 'GMT+2:00: Jerusalem',
             'Africa/Cairo' => 'GMT+2:00: Cairo',
             'Asia/Baghdad' => 'GMT+3:00: Baghdad',
             'Asia/Kuwait' => 'GMT+3:00: Kuwait, Riyadh',
             'Europe/Moscow' => 'GMT+3:00: Moscow, Saint Petersburg',
             'Africa/Nairobi' => 'GMT+3:00: Nairobi',
             'Asia/Tehran' => 'GMT+3:30: Tehran',
             'Asia/Muscat' => 'GMT+4:00: Abu Dhabi, Muscat',
             'Asia/Baku' => 'GMT+4:00: Baku, Tbilisi, Erivan',
             'Asia/Kabul' => 'GMT+4:00: Kabul',
             'Asia/Karachi' => 'GMT+5:00: Islamabad, Karachi, Taschkent',
             'Asia/Yekaterinburg' => 'GMT+5:00: Yekaterinburg',
             'Asia/Calcutta' => 'GMT+5:30: New Dehli',
             'Asia/Katmandu' => 'GMT+5:45: Katmandu',
             'Asia/Novosibirsk' => 'GMT+6:00: Almaty, Novosibirsk',
             'Asia/Dhaka' => 'GMT+6:00: Astana, Dhaka',
             'Asia/Rangoon' => 'GMT+6:00: Sri Jayawardenepura, Rangoon',
             'Asia/Jakarta' => 'GMT+7:00: Bangkok, Hanoi, Jakarta',
             'Asia/Krasnoyarsk' => 'GMT+7:00: Krasnoyarsk',
             'Asia/Irkutsk' => 'GMT+8:00: Irkutsk, Ulan Bator',
             'Asia/Singapore' => 'GMT+8:00: Kuala Lumpour, Singapore',
             'Asia/Hong_Kong' => 'GMT+8:00: Beijing, Chongqing, Hong kong, Urumchi',
             'Australia/Perth' => 'GMT+8:00: Perth',
             'Asia/Taipei' => 'GMT+8:00: Taipei',
             'Asia/Yakutsk' => 'GMT+9:00: Yakutsk',
             'Asia/Tokyo' => 'GMT+9:00: Osaka, Sapporo, Tokyo',
             'Asia/Seoul' => 'GMT+9:00: Seoul, Darwin, Adelaide',
             'Australia/Brisbane' => 'GMT+10:00: Brisbane',
             'Australia/Sydney' => 'GMT+10:00: Canberra, Melbourne, Sydney',
             'Pacific/Guam' => 'GMT+10:00: Guam, Port Moresby',
             'Australia/Hobart' => 'GMT+10:00: Hobart',
             'Asia/Vladivostok' => 'GMT+10:00: Vladivostok',
             'Asia/Magadan' => 'GMT+11:00: Salomon Islands, New Caledonia, Magadan',
             'Pacific/Auckland' => 'GMT+12:00: Auckland, Wellington',
             'Pacific/Fiji' => 'GMT+12:00: Fiji, Kamchatka, Marshall-Islands'
         );
     }

Here is the caller graph for this function:

◆ _isLeapYear()

static ilCalendarUtil::_isLeapYear ( int $a_year )

static

check if a given year is a leap year

Definition at line 366 of file class.ilCalendarUtil.php.

Referenced by ilCalendarRecurrenceCalculator\getYearWeekDays().

                                                    : bool
     {
         $is_leap = false;
         if ($a_year % 4 == 0) {
             $is_leap = true;
             if ($a_year % 100 == 0) {
                 $is_leap = false;
                 if ($a_year % 400) {
                     return true;
                 }
             }
         }
         return $is_leap;
     }

Here is the caller graph for this function:

◆ _isToday()

static ilCalendarUtil::_isToday ( ilDateTime $date )

static

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

References $DIC, ilDateTime\_equals(), IL_CAL_DAY, and IL_CAL_UNIX.

Referenced by ilMiniCalendarGUI\addMiniMonth(), ilCalendarBlockGUI\addMiniMonth(), and ilCalendarMonthGUI\show().

                                                      : bool
     {
         global $DIC;
 
         $ilUser = $DIC['ilUser'];
         if (!is_object(self::$today)) {
             self::$today = new ilDateTime(time(), IL_CAL_UNIX, $ilUser->getTimeZone());
         }
         return ilDateTime::_equals(self::$today, $date, IL_CAL_DAY, $ilUser->getTimeZone());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _numericDayToString()

static ilCalendarUtil::_numericDayToString	(	int	$a_day,
		bool	$a_long = `true`,
		?ilLanguage	$lng = `null`
	)

static

Parameters

int	day of week (0 for sunday, 1 for monday)
bool	short or long day translation

Definition at line 72 of file class.ilCalendarUtil.php.

References $DIC, and $lng.

Referenced by ilCalendarWeekGUI\addHeaderDate(), ilMiniCalendarGUI\addMiniMonth(), ilCalendarBlockGUI\addMiniMonth(), ilRecurrenceInputGUI\buildMonthlyByDaySelection(), ilRecurrenceInputGUI\buildWeekDaySelection(), ilRecurrenceInputGUI\buildYearlyByDaySelection(), ilSessionStatisticsGUI\exportCSV(), ilBookingReservationsTableGUI\fillRow(), ilBookingReservationsTableGUI\fillRowCSV(), ilBookingReservationsTableGUI\fillRowExcel(), ilSessionStatisticsGUI\getChart(), ILIAS\BookingManager\BookingProcess\WeekGridGUI\getHoursOfDay(), ilCalendarHeaderNavigationGUI\getHTML(), ilBookingReservationsTableGUI\initFilter(), ilCalendarDayGUI\show(), and ilCalendarMonthGUI\show().

                                                                                                         : string
     {
         global $DIC;
 
         if (is_null($lng)) {
             $lng = $DIC['lng'];
         }
         $lng->loadLanguageModule('dateplaner');
         static $days = array('Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su');
 
         return $a_long ? $lng->txt($days[$a_day] . '_long') : $lng->txt($days[$a_day] . '_short');
     }

Here is the caller graph for this function:

◆ _numericMonthToString()

static ilCalendarUtil::_numericMonthToString	(	int	$a_month,
		bool	$a_long = `true`,
		?ilLanguage	$lng = `null`
	)

static

numeric month to string

Parameters

int	month (1-12)
bool	short or long month translation

Definition at line 57 of file class.ilCalendarUtil.php.

References $DIC, and $lng.

Referenced by ilRecurrenceInputGUI\buildYearlyByDaySelection(), ilRecurrenceInputGUI\buildYearlyByMonthDaySelection(), ilDatePresentation\formatDate(), ILIAS\BookingManager\BookingProcess\WeekGridGUI\getHoursOfDay(), ilObjBlogGUI\renderNavigationByDate(), ilCalendarDayGUI\show(), ilCalendarMonthGUI\show(), and ilWikiStatGUI\viewToolbar().

                                                                                                             : string
     {
         global $DIC;
 
         if (is_null($lng)) {
             $lng = $DIC['lng'];
         }
         $month = $a_month < 10 ? '0' . $a_month : $a_month;
         return $a_long ? $lng->txt('month_' . $month . '_long') : $lng->txt('month_' . $month . '_short');
     }

Here is the caller graph for this function:

◆ calculateFontColor()

static ilCalendarUtil::calculateFontColor ( string $a_html_color_code )

static

Calculate best font color from html hex color code.

Parameters

string hex value of color

Returns: string #ffffff or #000000

Definition at line 398 of file class.ilCalendarUtil.php.

Referenced by ilCalendarWeekGUI\showAppointment(), ilCalendarDayGUI\showAppointment(), ilCalendarMonthGUI\showEvents(), ilCalendarWeekGUI\showFulldayAppointment(), and ilCalendarDayGUI\showFulldayAppointment().

                                                                         : string
     {
         if (strpos($a_html_color_code, '#') !== 0 or strlen($a_html_color_code) != 7) {
             return '#000000';
         }
 
         // http://en.wikipedia.org/wiki/Luminance_(relative)
         $lum = round(hexdec(substr($a_html_color_code, 1, 2)) * 0.2126 +
             hexdec(substr($a_html_color_code, 3, 2)) * 0.7152 +
             hexdec(substr($a_html_color_code, 5, 2)) * 0.0722);
         return ($lum <= 128) ? "#FFFFFF" : "#000000";
     }

Here is the caller graph for this function:

◆ convertDateToUtcDBTimestamp()

static ilCalendarUtil::convertDateToUtcDBTimestamp ( ?\ilDateTime $date = null )

static

Definition at line 30 of file class.ilCalendarUtil.php.

References IL_CAL_DATE, IL_CAL_DATETIME, null, and ilTimeZone\UTC.

Referenced by ilObjGroup\update(), and ilObjCourse\updateSettings().

                                                                                  : ?string
     {
         if (is_null($date)) {
             return null;
         }
         if ($date instanceof \ilDate) {
             return $date->get(IL_CAL_DATE);
         }
         return $date->get(IL_CAL_DATETIME, '', ilTimeZone::UTC);
     }

Here is the caller graph for this function:

◆ getHourSelection()

static ilCalendarUtil::getHourSelection ( int $a_format )

static

Get hour selection depending on user specific hour format.

Definition at line 414 of file class.ilCalendarUtil.php.

References ilCalendarSettings\TIME_FORMAT_12, and ilCalendarSettings\TIME_FORMAT_24.

Referenced by ilObjCalendarSettingsGUI\initFormSettings(), and ilCalendarUserSettingsGUI\initSettingsForm().

                                                           : array
     {
         $options = [];
         switch ($a_format) {
             case ilCalendarSettings::TIME_FORMAT_24:
                 for ($i = 0; $i < 24; $i++) {
                     $options[$i] = sprintf('%02d:00', $i);
                 }
                 break;
 
             case ilCalendarSettings::TIME_FORMAT_12:
                 for ($i = 0; $i < 24; $i++) {
                     $options[$i] = date('h a', mktime($i, 0, 0, 1, 1, 2000));
                 }
                 break;
         }
         return $options;
     }

Here is the caller graph for this function:

◆ getUserDateFormat()

static ilCalendarUtil::getUserDateFormat	(	int	$a_add_time = `0`,
		bool	$a_for_parsing = `false`
	)

static

Parse current user setting into date/time format.

Parameters

	?int	$a_add_time 1=hh:mm, 2=hh:mm:ss
bool	$a_for_parsing

Returns: string

Definition at line 478 of file class.ilCalendarUtil.php.

References $DIC, and ilCalendarSettings\TIME_FORMAT_24.

Referenced by ilPRGActionNoteBuilder\getUserDateFormat(), ilStudyProgrammeUserTable\getUserDateFormat(), and ILIAS\EmployeeTalk\Notification\NotificationHandler\send().

                                                                                               : string
     {
         global $DIC;
 
         $ilUser = $DIC['ilUser'];
 
         $format = (string) $ilUser->getDateFormat();
 
         if ($a_add_time) {
             $format .= " " . (($ilUser->getTimeFormat() == ilCalendarSettings::TIME_FORMAT_24)
                     ? "H:i"
                     : "h:ia");
             if ($a_add_time == 2) {
                 $format .= ":s";
             }
         }
 
         // translate datepicker format to PHP format
         if (!$a_for_parsing) {
             $format = str_replace("d", "DD", $format);
             $format = str_replace("m", "MM", $format);
             $format = str_replace("i", "mm", $format);
             $format = str_replace("Y", "YYYY", $format);
             $format = str_replace("H", "HH", $format);
             $format = str_replace("h", "hh", $format);
             $format = str_replace("s", "ss", $format);
         }
 
         return $format;
     }

Here is the caller graph for this function:

◆ getZoneInfoFile()

static ilCalendarUtil::getZoneInfoFile ( $a_tz )

static

Definition at line 275 of file class.ilCalendarUtil.php.

Referenced by ilCalendarExport\createTimezones().

                                                  : string
     {
         if (!array_key_exists($a_tz, self::_getShortTimeZoneList())) {
             return '';
         }
         $timezone_filename = str_replace('/', '_', $a_tz);
         $timezone_filename .= '.ics';
         return '../components/ILIAS/Calendar/zoneinfo/' . $timezone_filename;
     }

Here is the caller graph for this function:

◆ initDateTimePicker()

static ilCalendarUtil::initDateTimePicker ( )

static

Definition at line 509 of file class.ilCalendarUtil.php.

References $DIC.

Referenced by ilPageObjectGUI\initEditing(), and ilExerciseManagementGUI\initIndividualDeadlineModal().

                                                : void
     {
         global $DIC;
         $tpl = $DIC->ui()->mainTemplate();
 
         if (!self::$init_datetimepicker) {
             //$tpl->addJavaScript("assets/js/moment-with-locales.min.js");
             // unminified version does not work with jQuery 3.0
             // https://github.com/Eonasdan/bootstrap-datetimepicker/issues/1684
             //$tpl->addJavaScript("assets/js/bootstrap-datetimepicker.min.js");
             $tpl->addJavaScript("assets/js/Form.js"); // see ilPropertyFormGUI
             self::$init_datetimepicker = true;
         }
     }

Here is the caller graph for this function:

◆ initDefaultCalendarByType()

static ilCalendarUtil::initDefaultCalendarByType	(	int	$a_type_id,
		int	$a_usr_id,
		string	$a_title,
		bool	$a_create = `false`
	)

static

Init the default calendar for given type and user.

Definition at line 436 of file class.ilCalendarUtil.php.

References $DIC, $ilDB, $res, ilCalendarCategory\DEFAULT_COLOR, ilDBConstants\FETCHMODE_OBJECT, and null.

Referenced by ilConsultationHourUtils\bookAppointment(), ILIAS\BookingManager\BookingProcess\BookingProcessManager\bookSingle(), and ilConsultationHoursGUI\createAppointments().

      : ?ilCalendarCategory {
         global $DIC;
 
         $ilDB = $DIC['ilDB'];
         if (isset(self::$default_calendar[$a_usr_id]) and isset(self::$default_calendar[$a_usr_id][$a_type_id])) {
             return self::$default_calendar[$a_usr_id][$a_type_id];
         }
 
         $query = "SELECT cat_id FROM cal_categories " .
             "WHERE obj_id = " . $ilDB->quote($a_usr_id, 'integer') . " " .
             "AND type = " . $ilDB->quote($a_type_id, 'integer');
         $res = $ilDB->query($query);
         while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
             return self::$default_calendar[$a_usr_id][$a_type_id] = new ilCalendarCategory($row->cat_id);
         }
 
         if (!$a_create) {
             return null;
         }
 
         // Create default calendar
         self::$default_calendar[$a_usr_id][$a_type_id] = new ilCalendarCategory();
         self::$default_calendar[$a_usr_id][$a_type_id]->setType($a_type_id);
         self::$default_calendar[$a_usr_id][$a_type_id]->setColor(ilCalendarCategory::DEFAULT_COLOR);
         self::$default_calendar[$a_usr_id][$a_type_id]->setTitle($a_title);
         self::$default_calendar[$a_usr_id][$a_type_id]->setObjId($a_usr_id);
         self::$default_calendar[$a_usr_id][$a_type_id]->add();
 
         return self::$default_calendar[$a_usr_id][$a_type_id];
     }

Here is the caller graph for this function:

◆ initJSCalendar()

static ilCalendarUtil::initJSCalendar ( )

static

Definition at line 190 of file class.ilCalendarUtil.php.

References $DIC, and $lng.

                                            : void
     {
         global $DIC;
 
         $tpl = $DIC['tpl'];
         $lng = $DIC['lng'];
 
         if (self::$init_done == "done") {
             return;
         }
 
         $lng->loadLanguageModule("jscalendar");
         $tpl->addBlockFile(
             "CALENDAR_LANG_JAVASCRIPT",
             "calendar_javascript",
             "tpl.calendar.html",
             "components/ILIAS/Calendar"
         );
         $tpl->setCurrentBlock("calendar_javascript");
         $tpl->setVariable("FULL_SUNDAY", $lng->txt("l_su"));
         $tpl->setVariable("FULL_MONDAY", $lng->txt("l_mo"));
         $tpl->setVariable("FULL_TUESDAY", $lng->txt("l_tu"));
         $tpl->setVariable("FULL_WEDNESDAY", $lng->txt("l_we"));
         $tpl->setVariable("FULL_THURSDAY", $lng->txt("l_th"));
         $tpl->setVariable("FULL_FRIDAY", $lng->txt("l_fr"));
         $tpl->setVariable("FULL_SATURDAY", $lng->txt("l_sa"));
         $tpl->setVariable("SHORT_SUNDAY", $lng->txt("s_su"));
         $tpl->setVariable("SHORT_MONDAY", $lng->txt("s_mo"));
         $tpl->setVariable("SHORT_TUESDAY", $lng->txt("s_tu"));
         $tpl->setVariable("SHORT_WEDNESDAY", $lng->txt("s_we"));
         $tpl->setVariable("SHORT_THURSDAY", $lng->txt("s_th"));
         $tpl->setVariable("SHORT_FRIDAY", $lng->txt("s_fr"));
         $tpl->setVariable("SHORT_SATURDAY", $lng->txt("s_sa"));
         $tpl->setVariable("FULL_JANUARY", $lng->txt("l_01"));
         $tpl->setVariable("FULL_FEBRUARY", $lng->txt("l_02"));
         $tpl->setVariable("FULL_MARCH", $lng->txt("l_03"));
         $tpl->setVariable("FULL_APRIL", $lng->txt("l_04"));
         $tpl->setVariable("FULL_MAY", $lng->txt("l_05"));
         $tpl->setVariable("FULL_JUNE", $lng->txt("l_06"));
         $tpl->setVariable("FULL_JULY", $lng->txt("l_07"));
         $tpl->setVariable("FULL_AUGUST", $lng->txt("l_08"));
         $tpl->setVariable("FULL_SEPTEMBER", $lng->txt("l_09"));
         $tpl->setVariable("FULL_OCTOBER", $lng->txt("l_10"));
         $tpl->setVariable("FULL_NOVEMBER", $lng->txt("l_11"));
         $tpl->setVariable("FULL_DECEMBER", $lng->txt("l_12"));
         $tpl->setVariable("SHORT_JANUARY", $lng->txt("s_01"));
         $tpl->setVariable("SHORT_FEBRUARY", $lng->txt("s_02"));
         $tpl->setVariable("SHORT_MARCH", $lng->txt("s_03"));
         $tpl->setVariable("SHORT_APRIL", $lng->txt("s_04"));
         $tpl->setVariable("SHORT_MAY", $lng->txt("s_05"));
         $tpl->setVariable("SHORT_JUNE", $lng->txt("s_06"));
         $tpl->setVariable("SHORT_JULY", $lng->txt("s_07"));
         $tpl->setVariable("SHORT_AUGUST", $lng->txt("s_08"));
         $tpl->setVariable("SHORT_SEPTEMBER", $lng->txt("s_09"));
         $tpl->setVariable("SHORT_OCTOBER", $lng->txt("s_10"));
         $tpl->setVariable("SHORT_NOVEMBER", $lng->txt("s_11"));
         $tpl->setVariable("SHORT_DECEMBER", $lng->txt("s_12"));
         $tpl->setVariable("ABOUT_CALENDAR", $lng->txt("about_calendar"));
         $tpl->setVariable("ABOUT_CALENDAR_LONG", $lng->txt("about_calendar_long"));
         $tpl->setVariable("ABOUT_TIME_LONG", $lng->txt("about_time"));
         $tpl->setVariable("PREV_YEAR", $lng->txt("prev_year"));
         $tpl->setVariable("PREV_MONTH", $lng->txt("prev_month"));
         $tpl->setVariable("GO_TODAY", $lng->txt("go_today"));
         $tpl->setVariable("NEXT_MONTH", $lng->txt("next_month"));
         $tpl->setVariable("NEXT_YEAR", $lng->txt("next_year"));
         $tpl->setVariable("SEL_DATE", $lng->txt("select_date"));
         $tpl->setVariable("DRAG_TO_MOVE", $lng->txt("drag_to_move"));
         $tpl->setVariable("PART_TODAY", $lng->txt("part_today"));
         $tpl->setVariable("DAY_FIRST", $lng->txt("day_first"));
         $tpl->setVariable("CLOSE", $lng->txt("close"));
         $tpl->setVariable("TODAY", $lng->txt("today"));
         $tpl->setVariable("TIME_PART", $lng->txt("time_part"));
         $tpl->setVariable("DEF_DATE_FORMAT", $lng->txt("def_date_format"));
         $tpl->setVariable("TT_DATE_FORMAT", $lng->txt("tt_date_format"));
         $tpl->setVariable("WK", $lng->txt("wk"));
         $tpl->setVariable("TIME", $lng->txt("time"));
         $tpl->parseCurrentBlock();
         $tpl->setCurrentBlock("CalendarJS");
         $tpl->setVariable("LOCATION_JAVASCRIPT_CALENDAR", "./components/ILIAS/Calendar/js/calendar.js");
         $tpl->setVariable("LOCATION_JAVASCRIPT_CALENDAR_SETUP", "./components/ILIAS/Calendar/js/calendar-setup.js");
         $tpl->parseCurrentBlock();
 
         self::$init_done = "done";
     }

◆ parseDateString()

static ilCalendarUtil::parseDateString	(	string	$date,
		bool	$add_time = `false`,
		?string	$force_format = `null`
	)

static

Parse (incoming) string to date/time object.

Parameters

string	$date
bool	$add_time	1=hh:mm, 2=hh:mm:ss
bool	$a_use_generic_format

Returns: array date, warnings, errors

Exceptions

ilDateTimeException

Definition at line 532 of file class.ilCalendarUtil.php.

References $DIC, IL_CAL_DATE, IL_CAL_DATETIME, and null.

                                                                                                               : array
     {
         global $DIC;
 
         $ilUser = $DIC['ilUser'];
         if (!$force_format) {
             $out_format = self::getUserDateFormat($add_time, true);
         } else {
             $out_format = $force_format;
         }
 
         $tmp = date_parse_from_format($out_format, $date);
         $return_date = null;
 
         if (!$tmp["error_count"] &&
             !$tmp["warning_count"]) {
             $format = $tmp["year"] . "-" .
                 str_pad($tmp["month"], 2, "0", STR_PAD_LEFT) . "-" .
                 str_pad($tmp["day"], 2, "0", STR_PAD_LEFT);
 
             if ($add_time) {
                 $format .= " " .
                     str_pad($tmp["hour"], 2, "0", STR_PAD_LEFT) . ":" .
                     str_pad($tmp["minute"], 2, "0", STR_PAD_LEFT) . ":" .
                     str_pad($tmp["second"], 2, "0", STR_PAD_LEFT);
 
                 $return_date = new ilDateTime($format, IL_CAL_DATETIME, $ilUser->getTimeZone());
             } else {
                 $return_date = new ilDate($format, IL_CAL_DATE);
             }
         }
 
         return array(
             "date" => $return_date
             ,
             "warnings" => sizeof($tmp["warnings"])
                 ? $tmp["warnings"]
                 : null
             ,
             "errors" => sizeof($tmp["errors"])
                 ? $tmp["errors"]
                 : null
         );
     }

◆ parseIncomingDate()

static ilCalendarUtil::parseIncomingDate	(		$value,
		bool	$add_time = `false`
	)

static

Try to parse incoming value to date object.

Parameters

string \| ilDateTime	$value
int	$add_time

Returns: ilDateTime|ilDate

Definition at line 583 of file class.ilCalendarUtil.php.

References null.

Referenced by ilDateTimeInputGUI\checkInput(), ilDclGenericMultiInputGUI\checkInput(), ilDateDurationInputGUI\checkInput(), ilAdvancedMDFieldDefinitionDate\getLuceneSearchString(), ilAdvancedMDFieldDefinitionDateTime\getLuceneSearchString(), ilSessionStatisticsGUI\importDate(), ilADTDateSearchBridgeSingle\importFromPost(), ilADTDateTimeSearchBridgeSingle\importFromPost(), ilADTDateSearchBridgeRange\importFromPost(), ilADTDateTimeSearchBridgeRange\importFromPost(), ilDclGenericMultiInputGUI\setValue(), ilDateTimeInputGUI\setValueByArray(), ilDateDurationInputGUI\setValueByArray(), ilCourseContentGUI\updateManagedTimings(), and ilCourseContentGUI\updatePersonalTimings().

                                                                             : ?ilDateTime
     {
         // already datetime object?
         if ($value instanceof ilDateTime) {
             return $value;
         } elseif (!trim($value)) {
             return null;
         }
 
         // try user-specific format
         $parsed = self::parseDateString($value, $add_time);
         if (is_object($parsed['date'])) {
             return $parsed['date'];
         }
 
         // try the previously used generic format
         $format = $add_time ? 'Y-m-d H:i:s' : 'Y-m-d';
         $parsed = self::parseDateString($value, $add_time, $format);
         if (is_object($parsed['date'])) {
             return $parsed['date'];
         }
 
         // try the formats returned by html native datetime-local/date inputs
         $format = 'Y-m-d';
         if ($add_time) {
             // can be with or without seconds
             $format .= '\TH:i';
         }
         $parsed = self::parseDateString($value, $add_time, $format);
         if (is_object($parsed['date'])) {
             return $parsed['date'];
         }
 
         return null;
     }

Here is the caller graph for this function:

Field Documentation

◆ $default_calendar

array ilCalendarUtil::$default_calendar = array()

staticprivate

Definition at line 26 of file class.ilCalendarUtil.php.

◆ $init_datetimepicker

bool ilCalendarUtil::$init_datetimepicker = false

staticprotected

Definition at line 28 of file class.ilCalendarUtil.php.

◆ $init_done

string ilCalendarUtil::$init_done

static

Definition at line 27 of file class.ilCalendarUtil.php.

◆ $today

ilDateTime ilCalendarUtil::$today = null

staticprivate

Definition at line 25 of file class.ilCalendarUtil.php.

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

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

Static Public Member Functions

Static Public Attributes

Static Protected Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

◆ _buildMonthDayList()

◆ _buildWeekDayList()

◆ _getMaxDayOfMonth()

◆ _getShortTimeZoneList()

◆ _isLeapYear()

◆ _isToday()

◆ _numericDayToString()

◆ _numericMonthToString()

◆ calculateFontColor()

◆ convertDateToUtcDBTimestamp()

◆ getHourSelection()

◆ getUserDateFormat()

◆ getZoneInfoFile()

◆ initDateTimePicker()

◆ initDefaultCalendarByType()

◆ initJSCalendar()

◆ parseDateString()

◆ parseIncomingDate()

Field Documentation

◆ $default_calendar

◆ $init_datetimepicker

◆ $init_done

◆ $today