You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 46 Next »

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

NameTypeMandatoryDefault Value
startDateSimpleDateTimeYN
endDateSimpleDateTimeYN


Return:

TypeDescription
SimpleDurationThe 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):

NameTypeMandatoryDefault Value
sysIdIntegerYN
timeZoneString (empty string by default)N''

Return:

TypeDescription
VoidThis method does not return a value.

Example:

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

getname()

Returns a schedule name.


Return:

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

TypeDescription
BooleanTrue 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):

NameTypeMandatoryDefault Value
timeSimpleDateTimeYN


Return:

TypeDescription
BooleanTrue 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):

NameTypeMandatoryDefault Value
timeZoneStringYN


Return:

TypeDescription
VoidThis 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):

NameTypeMandatoryDefault Value
timeSimpleDateTimeYN
timeZone

String

N''

Return:

TypeDescription
SimpleDurationThe 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):

NameTypeMandatoryDefault Value
startDate

SimpleDateTime

YN
finalWorkingSecondsIntegerYN


Return:

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

  • No labels