Page History

Table of Contents

...

matches with the working time, and return the difference between the two time values.

SimpleSchedule(id, timezoneTitle)

Use this cinstructor to instantiate a new SimpleSchedule object.

Parameter(s):

Name	Type	Mandatory	Default Value
id	String	N	N
timezoneTitle	String	N	'UTC'

Example:

Code Block

language	js
theme	Eclipse
title	SimpleSchedule
linenumbers	true

const schedule = new SimpleSchedule('157165292607666710', 'UTC');

duration(startDateTime, endDateTime

...

load(sysId, timeZone)

Parameter(s):

...

Описание: Инициализирует расписание по sys_id.

Принимает: sysId - integer; (опционально) timeZone - string (по умолчанию - пустая строка).
Возвращает: Ничего.

Пример:

let simple_schedule = new SimpleSchedule();

simple_schedule.load('1');

...

Описание: Возвращает имя расписания.

Принимает: Ничего.
Возвращает: string.

Пример:

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

...

Описание: Проверяет, есть ли записи для выбранного расписания.

Принимает: Ничего.
Возвращает: boolean.

Пример:

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

...

Описание: Определяет, находится ли данное время в текущем расписании.

Принимает: SimpleDateTime.

Возвращает: boolean.

Пример:

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

...

Описание: Определяет, является время рабочим или нет.

Принимает: SimpleDateTime.
Возвращает: boolean.

Пример:

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

Не выносить в документацию

...

Описание: Устанавливает тайм-зону.

Принимает: string.
Возвращает: Ничего.

Пример:

...

js
title	getName

const schedule = new SimpleSchedule('157165292607666710');
ss.info(schedule.getName()); // Info: 8x5 excluding Russian Holidays

isInSchedule(datetime)

This method checks whether the current schedule includes the given datetime or they do not match.

Info
Excluded schedule segments will also return 'true' within checking by this method.

Parameter(s):

Name	Type	Mandatory	Default Value
datetime	SimpleDateTime	Y	N

Return:

Type	Description
Boolean	This method returns 'true' if the specified datetime is in schedule; otherwise, it returns 'false'.

Example:

Code Block

language	js
title	isInSchedule

const nowDatetime = new SimpleDateTime();
const schedule = new SimpleSchedule('157165292607666710'); // sys_schedule.sys_id
ss.info(schedule.isInSchedule(nowDatetime)); // Info: false

isValid()

The method checks if the specified SimpleSchedule object is valid.

Info

The object is considered as invalid when:

The schedule passed does not exist.
The schedule does not contain schedule elements of the working type. The example type for elements of such schedule is Time Off or Excluded.

In both cases above, the isValid() method returns 'false'.

Return:

Type	Description
Boolean	This method returns 'true' if the schedule is valid; otherwise, it returns 'false'.

Example:

Code Block

language	js
title	isValid

const schedule = new SimpleSchedule('157165292607666710'); // sys_schedule.sys_id
ss.info(schedule.isValid()); // Info: true

isWorkingTime(datetime)

This method checks whether a provided date and time is a working time or not.

Parameter(s):

Name	Type	Mandatory	Default Value
datetime	SimpleDateTime	Y	N

Return:

Type	Description
Boolean	This method returns 'true' if provided date and time is a working time; otherwise, it returns 'false'.

Code Block

language	js
theme	Eclipse
title	isWorkingTime
linenumbers	true

const schedule = new SimpleSchedule('157165292607666710'); // sys_schedule.sys_id
const firstDatetime = new SimpleDateTime('2020-12-15 05:59:59');
const secondDatetime = new SimpleDateTime('2020-12-15 06:00:00');
ss.info(schedule.isWorkingTime(firstDatetime)); // Info: false
ss.info(schedule.isWorkingTime(secondDatetime)); // Info: true

load(sysId, timezoneTitle)

This method initializes a schedule specified with the sys_id.

Parameter(s):

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

Return:

Type	Description
Void	This method does not return a value.

Example:

Code Block

language	js
title	load

const schedule = new SimpleSchedule();
schedule.load('157165292607666710'); // sys_schedule.sys_id

setTimeZone(timezoneTitle)

This method defines which time zone is to be applied to the current schedule.

Parameter(s):

Name	Type	Mandatory	Default Value
timezoneTitle	String	Y	N

Return:

Type	Description
Void	This method does not return a value.

Example:

Code Block

language	js
title	setTimeZone

const schedule = new SimpleSchedule('157165292607666710'); // sys_schedule.sys_id
schedule.setTimeZone('US/Central');

...

Описание: Определяет, когда истекает указанное рабочее время.

Принимает:startDate - SimpleDateTime, finalWorkingSeconds - integer
Возвращает: false|string.

Пример:

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

timezoneTitle)

This method returns the number of seconds left until the next schedule element starts.

Parameter(s):

Name	Type	Mandatory	Default Value
datetime	SimpleDateTime	Y	N
timezoneTitle	String	N	''

Return:

Type	Description
SimpleDuration	The SimpleDuration object.

Example:

Code Block

language	js
theme	Eclipse
title	whenNext
linenumbers	true

const startDatetime = new SimpleDateTime();
const schedule = new SimpleSchedule('161050499417811121'); // sys_schedule.sys_id
ss.info('Seconds Left: ' + schedule.whenNext(startDatetime).getDurationSeconds()); // Info: Seconds Left: 6052

whenWillExpire(startDateTime, finalWorkingSeconds)

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

Note
Please note that finalWorkingSeconds parameter does not support negative values.

Parameter(s):

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

Return:

Type	Description
SimpleDateTime object or 'null'	This method returns the SimpleDateTime object.

Note
If the SimpleSchedule class object is not valid (the isValid() method returns 'false' for this object), then the whenWillExpire() method returns 'null' for it.

Example:

Code Block

language	js
title	whenWillExpire

const startDatetime = new SimpleDateTime('2022-01-23 08:00:00');
const finalWorkingSeconds = 5 * 8 * 3600; // duration of 5 eight-hour days in seconds
const schedule = new SimpleSchedule('161050499417811121'); // sys_schedule.sys_id
ss.info(schedule.whenWillExpire(startDatetime, finalWorkingSeconds).getValue()); // Info: 2022-01-28 18:30:00

Table of Contents

absoluteUrl	true
class	fixedPosition

...

Описание: Определяет, сколько времени (в секундах) до времени начала следующего элемента расписания.

Принимает: time - SimpleDateTime; (опционально) timeZone - string (по умолчанию - пустая строка).

Возвращает: integer.

Пример:

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

Parameter(s):

...

Return:

...

Example:

...

Page tree

Versions Compared

Old Version 10

New Version Current

Key

SimpleSchedule(id, timezoneTitle)

duration(startDateTime, endDateTime

)

load(sysId, timeZone)

getName()

isInSchedule(datetime)

isValid()

isWorkingTime(datetime)

load(sysId, timezoneTitle)

setTimeZone(timezoneTitle)

whenNext(

datetime,

timezoneTitle)

whenWillExpire(startDateTime, finalWorkingSeconds)