Description | manuals and libraries |
Kernel::System::CronEvent - Cron Events wrapper functions
Functions to calculate cron events time.
create a CronEvent object. Do not use it directly, instead use:
my $CronEventObject = $Kernel::OM->Get('Kernel::System::CronEvent');
gets the time when the next cron event should occur, from a given time.
my $EventSystemTime = $CronEventObject->NextEventGet(
Schedule => '*/2 * * * *', # recurrence parameters based in cron notation
StartDateTime => $DateTimeObject, # optional
);
Returns:
my $EventDateTime = '2016-01-23 14:56:12'; # or false in case of an error
gets the time when the next cron events should occur, from a given time on a defined range.
my @NextEvents = $CronEventObject->NextEventList(
Schedule => '*/2 * * * *', # recurrence parameters based in cron notation
StartDateTime => $StartDateTimeObject, # optional, defaults to current date/time
StopDateTime => $StopDateTimeObject,
);
Returns:
my @NextEvents = [ '2016-01-12 13:23:01', ... ]; # or false in case of an error
gets the time when the last Cron event had occurred, from a given time.
my $PreviousSystemTime = $CronEventObject->PreviousEventGet(
Schedule => '*/2 * * * *', # recurrence parameters based in Cron notation
StartDateTime => $DateTimeObject, # optional, defaults to current date/time
);
Returns:
my $EventDateTime = '2016-03-12 11:23:45'; # or false in case of an error
converts a GenericAgent schedule to a CRON tab format string
my $Schedule = $CronEventObject->GenericAgentSchedule2CronTab(
ScheduleMinutes [1,2,3],
ScheduleHours [1,2,3],
ScheduleDays [1,2,3],
);
my $Schedule = '1,2,3 1,2,3 * * 1,2,3 *' # or false in case of an error
This software is part of the OTRS project (https://otrs.org/).
This software comes with ABSOLUTELY NO WARRANTY. For details, see the enclosed file COPYING for license information (GPL). If you did not receive this file, see https://www.gnu.org/licenses/gpl-3.0.txt.