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:
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:
let simple_schedule = new SimpleSchedule();
simple_schedule.load('1');
getname()
Returns a schedule name.
Return:
| Type | Description |
|---|---|
| String | The schedule name. |
Example:
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:
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 |
Example:
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:
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:
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:
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) | Описание: Определяет, когда истекает указанное рабочее время. Принимает:startDate - SimpleDateTime, finalWorkingSeconds - integer |
