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
startDate	SimpleDateTime
endDate	SimpleDateTime

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
sysId	Integer
timeZone	String (empty string by default)

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
time	SimpleDateTime

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
timeZone	String

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');

whenWillExpire(startDate, finalWorkingSeconds)

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

Parameter(s):

Name	Type
startDate	SimpleDateTime
finalWorkingSeconds	Integer

Return:

Type	Description
String	The time value.

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));

whenNext(time, timeZone)

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

Parameter(s):

Name	Type
time	SimpleDateTime
timeZone	String

Return:

Type	Description
Integer	The number in milliseconds.

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));

Page tree