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