Class for date presentation. More...

Collaboration diagram for ilDatePresentation:

Static Public Member Functions
static	setUseRelativeDates (bool $a_status)
	set use relative dates More...

static	useRelativeDates ()

static	setLanguage (ilLanguage $a_lng)

static	getLanguage ()

static	resetToDefaults ()
	reset to defaults More...

static	formatDate (ilDateTime $date, bool $a_skip_day=false, bool $a_include_wd=false, bool $include_seconds=false)

static	formatPeriod (ilDateTime $start, ilDateTime $end, bool $a_skip_starting_day=false)
	Format a period of two dates Shows: 14. More...

static	isToday (ilDateTime $date)
	Check if date is "today". More...

static	isYesterday (ilDateTime $date)
	Check if date is yesterday. More...

static	isTomorrow (ilDateTime $date)
	Check if date is tomorrow. More...

static	secondsToString (int $seconds, bool $force_with_seconds=false, ?ilLanguage $a_lng=null)
	converts seconds to string: Long: 7 days 4 hour(s) ... More...

Static Public Attributes
static bool	$use_relative_dates = true

static ilDateTime	$today = null

static ilDateTime	$tomorrow = null

static ilDateTime	$yesterday = null

Static Protected Attributes
static array	$weekdays

Static Private Attributes
static ilLanguage	$lang = null

Detailed Description

Class for date presentation.

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

Definition at line 31 of file class.ilDatePresentation.php.

Member Function Documentation

◆ formatDate()

static ilDatePresentation::formatDate	(	ilDateTime	$date,
		bool	$a_skip_day = `false`,
		bool	$a_include_wd = `false`,
		bool	$include_seconds = `false`
	)

static

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

References $DIC, $ilUser, $lng, ilCalendarUtil\_numericMonthToString(), ilDateTime\get(), ILIAS\UI\Implementation\Component\Input\getLanguage(), IL_CAL_FKT_DATE, IL_CAL_FKT_GETDATE, ilDateTime\isNull(), ilCalendarSettings\TIME_FORMAT_12, and ilCalendarSettings\TIME_FORMAT_24.

                                                                                                                                             : string
     {
         global $DIC;
 
         $lng = $DIC['lng'];
         $lng->loadLanguageModule('dateplaner');
         $ilUser = $DIC['ilUser'];
 
         if ($date->isNull()) {
             return self::getLanguage()->txt('no_date');
         }
 
         $has_time = !is_a($date, 'ilDate');
 
         // Converting pure dates to user timezone might return wrong dates
         $date_info = [];
         if ($has_time) {
             $date_info = $date->get(IL_CAL_FKT_GETDATE, '', $ilUser->getTimeZone());
         } else {
             $date_info = $date->get(IL_CAL_FKT_GETDATE, '', 'UTC');
         }
 
         $date_str = '';
         if (!$a_skip_day) {
             $sep = ", ";
             if (self::isToday($date) and self::useRelativeDates()) {
                 $date_str = self::getLanguage()->txt('today');
             } elseif (self::isTomorrow($date) and self::useRelativeDates()) {
                 $date_str = self::getLanguage()->txt('tomorrow');
             } elseif (self::isYesterday($date) and self::useRelativeDates()) {
                 $date_str = self::getLanguage()->txt('yesterday');
             } else {
                 $date_str = "";
                 if ($a_include_wd) {
                     $date_str = $lng->txt(self::$weekdays[$date_info['wday']]) . ",     ";
                 }
                 $date_str .= $date_info['mday'] . '. ' .
                     ilCalendarUtil::_numericMonthToString($date_info['mon'], false) . ' ' .
                     $date_info['year'];
             }
         } else {
             $sep = "";
         }
 
         if (!$has_time) {
             return $date_str;
         }
 
         $sec = ($include_seconds)
             ? ":s"
             : "";
 
         switch ($ilUser->getTimeFormat()) {
             case ilCalendarSettings::TIME_FORMAT_24:
                 return $date_str . $sep . $date->get(IL_CAL_FKT_DATE, 'H:i' . $sec, $ilUser->getTimeZone());
 
             case ilCalendarSettings::TIME_FORMAT_12:
                 return $date_str . $sep . $date->get(IL_CAL_FKT_DATE, 'g:ia' . $sec, $ilUser->getTimeZone());
         }
         return '';
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatPeriod()

static ilDatePresentation::formatPeriod	(	ilDateTime	$start,
		ilDateTime	$end,
		bool	$a_skip_starting_day = `false`
	)

static

Format a period of two dates Shows: 14.

Jul 2008 18:00 - 20:00 or: Today 18:00 - 20:00 or: 14. Jul 2008 - 16. Jul 2008 or: 14. Jul 2008, 12:00 - 16. Jul 2008, 14:00

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

References $DIC, $ilUser, ilDateTime\_equals(), ilDateTime\get(), IL_CAL_DATE, IL_CAL_DAY, IL_CAL_FKT_DATE, ilCalendarSettings\TIME_FORMAT_12, and ilCalendarSettings\TIME_FORMAT_24.

Referenced by ilSessionAppointment\_appointmentToString(), ilInfoScreenGUI\addAccessPeriodProperty(), ilObjectActivation\addListGUIActivationProperty(), ilCalendarEntry\appointmentToMailString(), ilObjRemoteTestGUI\availabilityToString(), ilObjRemoteCourseGUI\availabilityToString(), ilObjRemoteGroupGUI\availabilityToString(), ilCalendarAppointmentGUI\book(), ilSessionStatisticsGUI\buildData(), ilCalendarAppointmentGUI\cancelBooking(), ilAppointmentPresentationBookingPoolGUI\collectPropertiesAndActions(), ilECSCategoryMappingRule\conditionToString(), ilCalendarAppointmentGUI\confirmRegister(), ilCalendarAppointmentGUI\confirmUnregister(), ilObjUser\deleteUserDefinedFieldEntries(), ilBookingProcessGUI\displayPostInfo(), ilWikiStatGUI\export(), ilCalendarChangedAppointmentsTableGUI\fillRow(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilCalendarBlockGUI\getData(), ilCalendarAppointmentPanelGUI\getHTML(), ilCalendarAgendaListGUI\getHTML(), ilCalendarViewGUI\getModalForApp(), ilCalendarBlockGUI\getModalForApp(), ilObjSession\getPresentationTitleAppointmentPeriod(), ilTrQuery\getSessionData(), ilChatroomFormFactory\getSessionForm(), ilObjCourseGUI\infoScreen(), ilObjGroupGUI\infoScreen(), ilObjSessionGUI\initAttendanceList(), ilBookingProcessGUI\initBookingNumbersForm(), ilObjGroupAccess\lookupPeriodInfo(), ilObjCourseAccess\lookupPeriodInfo(), ilConsultationHoursTableGUI\parse(), ilAccountMail\replacePlaceholders(), ilBookingReservationsGUI\rsvConfirmCancel(), ilBookingReservationsGUI\rsvConfirmCancelAggregationForm(), ilBookingReservationsGUI\rsvConfirmDelete(), ilAccountMail\send(), ilCalendarAppointmentsTableGUI\setAppointments(), ilCalendarAppointmentGUI\showInfoScreen(), ilChatroomHistoryGUI\showMessages(), and ilMemberExport\write().

                                                                                                               : string
     {
         global $DIC;
 
         $ilUser = $DIC['ilUser'];
         $has_time = !is_a($start, 'ilDate');
 
         // Same day
         if (ilDateTime::_equals($start, $end, IL_CAL_DAY, $ilUser->getTimeZone())) {
             if (!$has_time) {
                 return self::formatDate($start);
             } else {
                 $date_str = "";
                 $sep = "";
                 if (!$a_skip_starting_day) {
                     $date_str = self::formatDate(
                         new ilDate($start->get(IL_CAL_DATE, '', $ilUser->getTimeZone()), IL_CAL_DATE)
                     );
                     $sep = ", ";
                 }
 
                 // $start == $end
                 if (ilDateTime::_equals($start, $end)) {
                     switch ($ilUser->getTimeFormat()) {
                         case ilCalendarSettings::TIME_FORMAT_24:
                             return $date_str . $sep . $start->get(IL_CAL_FKT_DATE, 'H:i', $ilUser->getTimeZone());
 
                         case ilCalendarSettings::TIME_FORMAT_12:
                             return $date_str . $sep . $start->get(IL_CAL_FKT_DATE, 'h:i a', $ilUser->getTimeZone());
                     }
                 } else {
                     switch ($ilUser->getTimeFormat()) {
                         case ilCalendarSettings::TIME_FORMAT_24:
                             return $date_str . $sep . $start->get(
                                 IL_CAL_FKT_DATE,
                                 'H:i',
                                 $ilUser->getTimeZone()
                             ) . ' - ' .
                                 $end->get(IL_CAL_FKT_DATE, 'H:i', $ilUser->getTimeZone());
 
                         case ilCalendarSettings::TIME_FORMAT_12:
                             return $date_str . $sep . $start->get(
                                 IL_CAL_FKT_DATE,
                                 'g:ia',
                                 $ilUser->getTimeZone()
                             ) . ' - ' .
                                 $end->get(IL_CAL_FKT_DATE, 'g:ia', $ilUser->getTimeZone());
                     }
                 }
             }
         }
         // Different days
         return self::formatDate($start, $a_skip_starting_day) . ' - ' . self::formatDate($end);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLanguage()

static ilDatePresentation::getLanguage ( )

static

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

References $DIC, $lang, and $lng.

Referenced by ilMailTemplateContext\resolvePlaceholder().

                                         : ilLanguage
     {
         global $DIC;
 
         $lng = $DIC->language();
         return self::$lang ?: $lng;
     }

Here is the caller graph for this function:

◆ isToday()

static ilDatePresentation::isToday ( ilDateTime $date )

static

Check if date is "today".

Definition at line 215 of file class.ilDatePresentation.php.

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

                                                     : 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:

◆ isTomorrow()

static ilDatePresentation::isTomorrow ( ilDateTime $date )

static

Check if date is tomorrow.

Definition at line 246 of file class.ilDatePresentation.php.

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

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

Here is the call graph for this function:

◆ isYesterday()

static ilDatePresentation::isYesterday ( ilDateTime $date )

static

Check if date is yesterday.

Definition at line 230 of file class.ilDatePresentation.php.

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

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

Here is the call graph for this function:

◆ resetToDefaults()

static ilDatePresentation::resetToDefaults ( )

static

reset to defaults

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

References $DIC, and $lng.

Referenced by ilObjUser\deleteUserDefinedFieldEntries(), ilLPProgressTableGUI\fillRowCSV(), and ilRoleAssignmentTableGUI\getTitleForReference().

     {
         global $DIC;
 
         $lng = $DIC->language();
         self::setLanguage($lng);
         self::setUseRelativeDates(true);
     }

Here is the caller graph for this function:

◆ secondsToString()

static ilDatePresentation::secondsToString	(	int	$seconds,
		bool	$force_with_seconds = `false`,
		?ilLanguage	$a_lng = `null`
	)

static

converts seconds to string: Long: 7 days 4 hour(s) ...

Definition at line 263 of file class.ilDatePresentation.php.

References $DIC, $lng, $message, and $rest.

Referenced by ilLearningProgressBaseGUI\__appendLPDetails(), ilSessionReminderCheck\__construct(), ilCourseContentGUI\__renderUserItem(), ilLearningProgressBaseGUI\__showObjectDetails(), ilInfoScreenGUI\addMetaDataSections(), ilTimingOverviewTableGUI\fillRow(), ilCalendarAppointmentsTableGUI\fillRow(), ilTrUserObjectsPropsTableGUI\fillRow(), ilCourseMailTemplateTutorContext\getCachedPeriodByObjId(), ilScormMailTemplateLPContext\getDescription(), ilObjSCORM2004LearningModule\getTrackingDataAgg(), ilObjUserFolderGUI\initFormGeneralSettings(), ilPersonalSettingsGUI\initGeneralSettingsForm(), ilLPTableBaseGUI\parseValue(), ilTrSummaryTableGUI\parseValue(), and ilLearningProgressGUI\showtlt().

      : string {
         global $DIC;
 
         $lng = $DIC['lng'];
         $message = null;
 
         if ($a_lng) {
             $lng = $a_lng;
         }
 
         $seconds = $seconds ?: 0;
 
         // #13625
         if ($seconds > 0) {
             $days = floor($seconds / 86400);
             $rest = $seconds % 86400;
 
             $hours = floor($rest / 3600);
             $rest = $rest % 3600;
 
             $minutes = floor($rest / 60);
             $seconds = $rest % 60;
         } else {
             $days = ceil($seconds / 86400);
             $rest = $seconds % 86400;
 
             $hours = ceil($rest / 3600);
             $rest = $rest % 3600;
 
             $minutes = ceil($rest / 60);
             $seconds = $rest % 60;
         }
 
         if ($days) {
             $message = $days . ' ' . ($days == 1 ? $lng->txt('day') : $lng->txt('days'));
         }
         if ($hours) {
             if ($message) {
                 $message .= ' ';
             }
             $message .= ($hours . ' ' . ($hours == 1 ? $lng->txt('hour') : $lng->txt('hours')));
         }
         if ($minutes) {
             if ($message) {
                 $message .= ' ';
             }
             $message .= ($minutes . ' ' . ($minutes == 1 ? $lng->txt('minute') : $lng->txt('minutes')));
         }
         if ($force_with_seconds && $seconds) {
             if ($message) {
                 $message .= ' ';
             }
             $message .= ($seconds . ' ' . ($seconds == 1 ? $lng->txt('second') : $lng->txt('seconds')));
         }
         if (!$days and !$hours and !$minutes) {
             return $seconds . ' ' . ($seconds == 1 ? $lng->txt('second') : $lng->txt('seconds'));
         } else {
             return $message;
         }
     }

Here is the caller graph for this function:

◆ setLanguage()

static ilDatePresentation::setLanguage ( ilLanguage $a_lng )

static

Definition at line 63 of file class.ilDatePresentation.php.

References $lang.

Referenced by ilForumMailNotification\createMailDate(), ilForumMailEventNotificationSender\createMailDate(), ilObjUser\deleteUserDefinedFieldEntries(), ilMailTemplateContext\resolvePlaceholder(), ilCronDeleteInactiveUserReminderMailNotification\send(), ilForumMailEventNotificationSender\send(), and ilForumMailNotification\send().

                                                          : void
     {
         self::$lang = $a_lng;
     }

Here is the caller graph for this function:

◆ setUseRelativeDates()

static ilDatePresentation::setUseRelativeDates ( bool $a_status )

static

set use relative dates

Definition at line 53 of file class.ilDatePresentation.php.

Referenced by ilBookingReservationsTableGUI\__construct(), ILIAS\Survey\InfoScreen\InfoScreenGUI\addAppraiseeInfo(), ilCalendarEntry\appointmentToMailString(), ilSessionStatisticsGUI\buildData(), ilNoteGUI\deleteNote(), ilPersonalSettingsGUI\deleteOwnAccount3(), ilObjUser\deleteUserDefinedFieldEntries(), ilBookingProcessGUI\displayPostInfo(), ilSurveyEvaluationGUI\evaluation(), ilSessionStatisticsGUI\exportCSV(), ilSurveyEvaluationGUI\exportEvaluationUser(), ilLMDownloadTableGUI\fillRow(), ilPollBlockGUI\fillRow(), assFileUploadFileTableGUI\fillRow(), ilQuestionPoolPrintViewTableGUI\fillRow(), ilLPProgressTableGUI\fillRowCSV(), ilCertificateDateHelper\formatDate(), ilTestPassOverviewTableGUI\formatDate(), ilCertificateDateHelper\formatDateTime(), ilGroupMembershipGUI\getAttendanceListUserData(), ilCourseMailTemplateMemberContext\getCachedPeriodByObjId(), ilCourseMailTemplateTutorContext\getCachedPeriodByObjId(), ilPersonalSkillsGUI\getEvalItem(), ilBlogExerciseGUI\getExerciseInfo(), ilPortfolioExerciseGUI\getExerciseInfo(), ilLPTableBaseGUI\getExportMeta(), ilDclEditViewTableGUI\getHTML(), ilCalendarHeaderNavigationGUI\getHTML(), ilDclCreateViewTableGUI\getHTML(), ilDclTableViewEditFieldsTableGUI\getHTML(), ilDclTableListTableGUI\getHTML(), ilDclFieldListTableGUI\getHTML(), ilDclTableViewTableGUI\getHTML(), ilAttendanceList\getHTML(), ilTable2GUI\getHTML(), ilObjectMetaDataGUI\getKeyValueList(), ilObjectMetaDataBlockGUI\getLegacyContent(), ilNoteGUI\getNoteListHTML(), ilBlogPostingGUI\getPageHeading(), ILIAS\Portfolio\PortfolioPrintViewProviderGUI\getPages(), ILIAS\Survey\Mode\IndividualFeedback\UIModifier\getPanelText(), ilEmployeeTalkAppointmentGUI\getPendingTalkDates(), ILIAS\Survey\PrintView\ResultsPerUserPrintViewProviderGUI\getPrintHeader(), ILIAS\Survey\PrintView\ResultsDetailsPrintViewProviderGUI\getPrintHeader(), ilCourseMembershipGUI\getPrintMemberData(), ilTermsOfServiceDocumentGUI\getResetMessageBoxHtml(), ILIAS\COPage\Editor\Components\Paragraph\ParagraphResponseFactory\getResponseObject(), ILIAS\COPage\Editor\Components\Paragraph\ParagraphResponseFactory\getResponseObjectMulti(), ilTestServiceGUI\getResultsSignature(), ilRoleAssignmentTableGUI\getTitleForReference(), ilObjSessionGUI\initAttendanceList(), ilPCSection\insertTimings(), ilBadgeProfileGUI\listBackpackGroups(), ilBadgeProfileGUI\listBadges(), ilUserCertificateGUI\listCertificates(), ilTestServiceGUI\populatePassFinishDate(), ilObjTestGUI\printobject(), ilForumExportGUI\printPost(), ilForumExportGUI\printThread(), ilObjTestGUI\reviewobject(), ilBookingReservationsGUI\rsvConfirmCancelAggregationForm(), ilMembershipCronNotifications\run(), ilSkillNotifications\run(), ilCronManagerImpl\runActiveJobs(), ilCronDeleteInactiveUserReminderMailNotification\send(), ilForumMailEventNotificationSender\send(), ilForumMailNotification\send(), ilTestMailNotification\sendAdvancedNotification(), ILIAS\COPage\Editor\Server\UIWrapper\sendPage(), ilTestMailNotification\sendSimpleNotification(), ILIAS\COPage\Editor\Components\Table\TableCommandActionHandler\sendUpdateResponse(), ilChatroomHistoryGUI\showMessages(), and ilMemberExport\write().

                                                               : void
     {
         self::$use_relative_dates = $a_status;
     }

Here is the caller graph for this function:

◆ useRelativeDates()

static ilDatePresentation::useRelativeDates ( )

static

Definition at line 58 of file class.ilDatePresentation.php.

Referenced by ilNoteGUI\deleteNote(), ilBookingProcessGUI\displayPostInfo(), ilPollBlockGUI\fillRow(), ilCertificateDateHelper\formatDate(), ilTestPassOverviewTableGUI\formatDate(), ilCertificateDateHelper\formatDateTime(), ilCourseMailTemplateMemberContext\getCachedPeriodByObjId(), ilCourseMailTemplateTutorContext\getCachedPeriodByObjId(), ilBlogExerciseGUI\getExerciseInfo(), ilPortfolioExerciseGUI\getExerciseInfo(), ilObjectMetaDataGUI\getKeyValueList(), ilObjectMetaDataBlockGUI\getLegacyContent(), ilNoteGUI\getNoteListHTML(), ilBlogPostingGUI\getPageHeading(), ilEmployeeTalkAppointmentGUI\getPendingTalkDates(), ilTermsOfServiceDocumentGUI\getResetMessageBoxHtml(), ilTestServiceGUI\getResultsSignature(), ilUserCertificateGUI\listCertificates(), ilTestServiceGUI\populatePassFinishDate(), ilObjTestGUI\printobject(), ilObjTestGUI\reviewobject(), ilMembershipCronNotifications\run(), ilSkillNotifications\run(), ilCronManagerImpl\runActiveJobs(), ilCronDeleteInactiveUserReminderMailNotification\send(), ilForumMailEventNotificationSender\send(), ilForumMailNotification\send(), and ilChatroomHistoryGUI\showMessages().

                                              : bool
     {
         return self::$use_relative_dates;
     }

Here is the caller graph for this function:

Field Documentation

◆ $lang

ilLanguage ilDatePresentation::$lang = null

staticprivate

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

◆ $today

ilDateTime ilDatePresentation::$today = null

static

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

◆ $tomorrow

ilDateTime ilDatePresentation::$tomorrow = null

static

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

◆ $use_relative_dates

bool ilDatePresentation::$use_relative_dates = true

static

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

◆ $weekdays

array ilDatePresentation::$weekdays

staticprotected

Initial value:

= array(
        0 => "Su_short",
        1 => "Mo_short",
        2 => "Tu_short",
        3 => "We_short",
        4 => "Th_short",
        5 => "Fr_short",
        6 => "Sa_short"
    )

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

◆ $yesterday

ilDateTime ilDatePresentation::$yesterday = null

static

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

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

Services/Calendar/classes/class.ilDatePresentation.php

Static Public Member Functions

Static Public Attributes

Static Protected Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

◆ formatDate()

◆ formatPeriod()

◆ getLanguage()

◆ isToday()

◆ isTomorrow()

◆ isYesterday()

◆ resetToDefaults()

◆ secondsToString()

◆ setLanguage()

◆ setUseRelativeDates()

◆ useRelativeDates()

Field Documentation

◆ $lang

◆ $today

◆ $tomorrow

◆ $use_relative_dates

◆ $weekdays

◆ $yesterday