SimpleSchedule

This server class provides methods for performing operations on SimpleSchedule objects, such as getting schedule name; determining if the current time value is working time or not or setting time zone for the schedule.

duration(startDate, endDate)

This method determines elapsed time in seconds in the schedule between two date-time values, using schedule time zone or, if not specified, the session time zone.

Parameter(s):

Name	Type	Mandatory	Default Value
startDate	SimpleDateTime	Y	N
endDate	SimpleDateTime	Y	N

Return:

Type	Description
SimpleDuration	The difference between two time values (in seconds).

Example:

duration

let startDate = new SimpleDateTime('2019-10-25 08:00:00');
let endDate = new SimpleDateTime('2019-10-29 08:00:00');
let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
let duration = simple_schedule.duration(startDate, endDate);
ss.info(duration.getValue());

load(sysId, timeZone)

Initializes a schedule by the sys_id.

Parameter(s):

Name	Type	Mandatory	Default Value
sysId	Integer	Y	N
timeZone	String (empty string by default)	N	''

Return:

Type	Description
Void	This method does not return a value.

Example:

load

let simple_schedule = new SimpleSchedule();
simple_schedule.load('1');

getname()

Returns a schedule name.

Return:

Type	Description
String	The schedule name.

Example:

getName

let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
ss.info(simple_schedule.getName());

isValid()

Determines if the specified schedule is valid.

Return:

Type	Description
Boolean	True if the schedule is valid.

Example:

isValid

let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
ss.info(simple_schedule.isValid());

isInSchedule(time)

Determines if the given datetime is within the current schedule.

Parameter(s):

Name	Type	Mandatory	Default Value
time	SimpleDateTime	Y	N

Return:

Type	Description
Boolean	True if the specified datetime is in schedule; otherwise false.

Example:

isInSchedule

let time = new SimpleDateTime();
let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
ss.info(simple_schedule.isInSchedule(time));

setTimeZone(timeZone)

Setting a time zone.

Parameter(s):

Name	Type	Mandatory	Default Value
timeZone	String	Y	N

Return:

Type	Description
Void	This method does not return a value.

Example:

setTimeZone

let time = new SimpleDateTime();
let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
simple_schedule.setTimeZone('US/Central');

whenNext(time, timeZone)

Determines how much time (in seconds) is left until next schedule item starts.

Parameter(s):

Name	Type	Mandatory	Default Value
time	SimpleDateTime	Y	N
timeZone	String	N	''

Return:

Type	Description
SimpleDuration	The SimpleDuration object

Example:

whenNext

let startDate = new SimpleDateTime('2019-10-25 08:00:00');
let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
ss.info(simple_schedule.whenNext(startDate));

whenWillExpire(startDate, finalWorkingSeconds)

This method determines the time after working seconds value specified in the finalWorkingSeconds parameter passes.

Parameter(s):

Name	Type	Mandatory	Default Value
startDate	SimpleDateTime	Y	N
finalWorkingSeconds	Integer	Y	N

Return:

Type	Description
SimpleDateTime	The SimpleDateTime object

Example:

whenWillExpire

let startDate = new SimpleDateTime('2019-10-25 08:00:00');
let finalWorkingSeconds = 12345;
let simple_schedule = new SimpleSchedule('1', 'Europe/Moscow');
ss.info(simple_schedule.whenWillExpire(startDate, finalWorkingSeconds));

Page tree