Функции

Описание

Суммирует два значения. Конкатенация строк не поддерживается.

Синтаксис функции

ADD(аргумент1, аргумент2)

Аргументы

Возвращает

Описание

Оператор логического ""И"" использует в качестве аргументов два значения логического типа (boolean) или выражения, результатом которых являются значения логического типа, и возвращает логическое значение истина (true), если оба аргумента являются истиной, в противном случае возвращает результат ложь (false).

Синтаксис функции

AND(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение логического типа (boolean) или выражение, результатом которого является значение логического типа.

Возвращает

логическое значение

Описание

Возвращает среднее арифметическое значений списка, являющегося аргументом.

Синтаксис функции

AVERAGE(аргумент1)

Аргументы

аргумент1: список, состоящий из значений типачисло (number), длительность (duration) или дата/время (datetime).

Возвращает

Тип возвращаемого значения тот же, что и у элементов списка, являющегося аргументом.

Описание

Возвращает значение числа, округленного до ближайшего большего целого.

Синтаксис функции

CEIL(аргумент1)

Аргументы

аргумент1: число

Возвращает

число

Описание

Использует в качестве аргумента список строк. Возвращает строку, состоящую из последовательно объединенных строк списка.

Синтаксис функции

CONCAT(LIST(строка1, строка2,...., строкаN))

Аргументы

LIST(строка1, строка2,...., строкаN): список значений типа строка (string)

Возвращает

строка (string)

Описание

Используются два аргумента одного типа: список в качестве аргумента1 и значение в качестве аргумента2. Возвращает логическое значение истина (true), если аргумент2 содержится в списке аргумента1, в противном случае возвращает результат ложь (false).

Синтаксис функции

CONTAINS(аргумент1, аргумент2)

Аргументы

аргумент1: список, состоящий из значений типа число (number), длительность (duration) или дата/время (datetime). Является константой (например 10, 20. Неправильно: $number1, $number2)

аргумент2: значение типа число (number), длительность (duration) или дата/время (datetime).

Возвращает

логическое значение

Описание

Использует в качестве аргумента список с элементами любого типа, выполняет подсчет количества элементов в списке.

Синтаксис функции

COUNT(аргумент1)

Аргументы

аргумент1: список с элементами любого типа.

Возвращает

число

Описание

Возвращает идентификатор учетной записи текущего пользователя.

Синтаксис функции

CURRENTUSER

Аргументы

аргументы не требуются

Возвращает

идентификатор учетной записи текущего пользователя

Описание

Конвертирует заданное количество секунд в дату.

Синтаксис функции

DATETIMEFROMSECONDS(аргумент1)

Аргументы

аргумент1: число

Возвращает

дата/время (datetime)

Описание

Конвертирует заданную в качестве аргумента дату в количество секунд, прошедшее с 00:00:00 1 января 1970 года (Unix-время).

Синтаксис функции

DATETIMEINSECONDS(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает числовое значение, соответствующее году указанной даты в местном часовом поясе.

Синтаксис функции

DATETIMEYEAR(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Возвращает числовое значение, соответствующее году указанной даты (аргумент1) в заданном часовом поясе (аргумент2). Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

DATETIMEYEARTZ(аргумент1, аргумент2)

Аргументы

аргумент1: дата/время (datetime)

аргумент2: строка

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает числовое значение, соответствующее месяцу указанной даты в местном часовом поясе.

Синтаксис функции

DATETIMEMONTH(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Возвращает числовое значение, соответствующее месяцу указанной даты (аргумент1) в заданном часовом поясе (аргумент2). Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

DATETIMEMONTHTZ(аргумент1, аргумент2)

Аргументы

аргумент1: дата/время (datetime)

аргумент2: строка

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает числовое значение, представляющее день месяца указанной даты в местном часовом поясе.

Синтаксис функции

DATETIMEDAY(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Возвращает числовое значение, представляющее день месяца указанной даты (аргумент1) в заданном часовом поясе (аргумент2). Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

DATETIMEDAYTZ(аргумент1, аргумент2)

Аргументы

аргумент1: дата/время (datetime)

аргумент2: строка

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает числовое значение, представляющее час суток указанной даты в местном часовом поясе.

Синтаксис функции

DATETIMEHOUR(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Возвращает числовое значение, представляющее час суток указанной даты (аргумент1) в заданном часовом поясе (аргумент2). Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

DATETIMEHOURTZ(аргумент1, аргумент2)

Аргументы

аргумент1: дата/время (datetime)

аргумент2: строка

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает числовое значение, представляющее минуту часа указанной даты в местном часовом поясе.

Синтаксис функции

DATETIMEMINUTE(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Возвращает числовое значение, представляющее минуту часа указанной даты (аргумент1) в заданном часовом поясе (аргумент2). Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

DATETIMEMINUTETZ(аргумент1, аргумент2)

Аргументы

аргумент1: дата/время (datetime)

аргумент2: строка

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает числовое значение, представляющее секунды указанной даты в местном часовом поясе.

Синтаксис функции

DATETIMESECOND(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

число

Описание

Возвращает числовое значение, представляющее секунды указанной даты (аргумент1) в заданном часовом поясе (аргумент2). Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

DATETIMESECONDTZ(аргумент1, аргумент2)

Аргументы

аргумент1: дата/время (datetime)

аргумент2: строка

Возвращает

число

Описание

Использует в качестве аргументов два значения числового типа и возвращает результат деления одного на другое.

Синтаксис функции

DIVIDE(аргумент1, аргумент2)

Аргументы

аргумент1 (делимое): число

аргумент2 (делитель): число

Возвращает

число

Описание

Конвертирует заданное количество секунд в длительность.

Синтаксис функции

DURATIONFROMSECONDS(аргумент1)

Аргументы

аргумент1: число

Возвращает

длительность

Описание

Конвертирует заданную в качестве аргумента длительность в количество секунд.

Синтаксис функции

DURATIONINSECONDS(аргумент1)

Аргументы

аргумент1: длительность

Возвращает

число

Описание

Использует в качестве аргумента выражение, результатом которого является некоторое значение, после чего проверяет данное значение на пустоту.

Синтаксис функции

EMPTY(аргумент1)

Аргументы

аргумент1: значение, являющееся результатом выражения, заданного в качестве аргумента, и имеющее один с ним тип.

Возвращает

логическое значение

Описание

Сравнивает два аргумента и возвращает логическое значение истина (true), если аргумент1 равен аргументу2, в противном случае возвращает результат ложь (false).

Синтаксис функции

EQUALS(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение любого типа.

Возвращает

логическое значение

Описание

Возвращает значение числа, округленного до ближайшего меньшего целого.

Синтаксис функции

FLOOR(аргумент1)

Аргументы

аргумент1:

Возвращает

число

Описание

Выполняет форматирование аргументов в соответствии с заданным шаблоном и возвращает отформатированную строку.

Синтаксис функции

FORMAT(строка задания формата, LIST(аргумент0, аргумент1, ..., аргументN))

Формат для аргумента0 задается частью строки, обозначенной как {0}. Формат для аргумента1 определяется частью строки {1} и так далее.

Аргументы должны быть записаны в следующем виде: LIST(аргумент1, аргумент2, ..., аргументN).

Также возможно использование функции FORMAT() для конкатенации строк. Например, FORMAT(""{0}, {1}"", LIST($title, $assignee)).

Аргументы

строка задания формата: строка

аргумент1, аргумент2, ..., аргументN: значения любого типа.

Возвращает

строка

Описание

Возвращает логическое значение истина (true), если аргумент1 больше аргумента2, в противном случае возвращает результат ложь (false).

Синтаксис функции

GREATER(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение типа число (number), длительность (duration) или дата/время (datetime).

Возвращает

логическое значение

Описание

Возвращает логическое значение истина (true), если аргумент1 больше либо равен аргументу2, в противном случае возвращает результат ложь (false).

Синтаксис функции

GREATEREQ(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение типа число (number), длительность (duration) или дата/время (datetime).

Возвращает

логическое значение

Описание

Использует в качестве аргументов значения или выражения, результатом которых является некоторое значение. Возвращает аргумент2, если аргумент1 является истиной (true), в противном случае возвращает аргумент3.

Синтаксис функции

IF(аргумент1, аргумент2, аргумент3)

Аргументы

аргумент1: значение логического типа (boolean) или выражение, результатом которого является значение логического типа.

аргумент2, аргумент3: значение любого типа или выражение, результатом которого является значение любого типа.

Возвращает

Тип возвращаемого значения тот же, что и у аргументов (аргумент2 или аргумент3).

Описание

Возвращает логическое значение истина (true), если заданная в качестве аргумента дата — сегодняшняя, в противном случае возвращает результат ложь (false).

Синтаксис функции

ISTODAY(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

логическое значение

Описание

Возвращает логическое значение истина (true), если аргумент1 меньше аргумента2, в противном случае возвращает результат ложь (false).

Синтаксис функции

LESS(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение типа число (number), дата/время (datetime) или длительность (duration).

Возвращает

логическое значение

Описание

Возвращает логическое значение истина (true), если аргумент1 меньше либо равен аргументу2, в противном случае возвращает результат ложь (false).

Синтаксис функции

LESSEQ(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение типа число (number), дата/время (datetime) или длительность (duration).

Возвращает

логическое значение

Описание

Определяет максимальное значение при помощи функции GREATER среди всех элементов списка, заданного в качестве аргумента. Элементы списка могут быть значениями или выражениями, результатом которых является значение. Все элементы списка должны быть одного типа.

Синтаксис функции

MAX(аргумент1)

Аргументы

аргумент1: список, состоящий из значений типа число (number), длительность (duration) или дата/время (datetime).

Возвращает

Тип возвращаемого значения тот же, что и у элементов списка, являющегося аргументом.

Описание

Возвращает дату в местном часовом поясе, соответствующую указанным значениям года, месяца и дня.

Синтаксис функции

MAKEDATE(аргумент1, аргумент2, аргумент3)

Аргументы

аргумент1: числовое значение, соответствующее году.

аргумент2: числовое значение, соответствующее месяцу.

аргумент3: числовое значение, соответствующее дню.

Возвращает

дата/время (datetime)

Описание

Возвращает дату в заданном часовом поясе, соответствующую указанным значениям года, месяца и дня. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

MAKEDATETZ(аргумент1, аргумент2, аргумент3, аргумент4)

Аргументы

аргумент1: числовое значение, соответствующее году.

аргумент2: числовое значение, соответствующее месяцу.

аргумент3: числовое значение, соответствующее дню.

аргумент4: строка, соответствующая идентификатору часового пояса.

Возвращает

дата/время (datetime)

Описание

Возвращает дату и время в местном часовом поясе, соответствующие указанным значениям года, месяца, дня, часа, минут и секунд.

Синтаксис функции

MAKEDATETIME(аргумент1, аргумент2, аргумент3, аргумент4, аргумент5, аргумент6)

Аргументы

аргумент1: числовое значение, соответствующее году.

аргумент2: числовое значение, соответствующее месяцу.

аргумент3: числовое значение, соответствующее дню.

аргумент4: числовое значение, соответствующее часам.

аргумент5: числовое значение, соответствующее минутам.

аргумент6: числовое значение, соответствующее секундам.

Возвращает

дата/время (datetime)

Описание

Возвращает дату и время в заданном часовом поясе, соответствующие указанным значениям года, месяца, дня, часа, минут и секунд. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA.

Синтаксис функции

MAKEDATETIMETZ(аргумент1, аргумент2, аргумент3, аргумент4, аргумент5, аргумент6, аргумент7)

Аргументы

аргумент1: числовое значение, соответствующее году.

аргумент2: числовое значение, соответствующее месяцу.

аргумент3: числовое значение, соответствующее дню.

аргумент4: числовое значение, соответствующее часам.

аргумент5: числовое значение, соответствующее минутам.

аргумент6: числовое значение, соответствующее секундам.

аргумент7: строка, соответствующая идентификатору часового пояса.

Возвращает

дата/время (datetime)

Описание

Использует в качестве аргументов строку (string) и регулярное выражение. Возвращает логическое значение истина (true), если какая-либо часть строки или строка полностью соответствует условию, заданному регулярным выражением. В противном случае возвращает результат ложь (false).

Синтаксис функции

MATCHES(аргумент1, аргумент2)

Аргументы

аргумент1: строка

аргумент2: регулярное выражение

Возвращает

логическое значение

Описание

Определяет минимальное значение при помощи функции LESS среди всех элементов списка, заданного в качестве аргумента. Элементы списка могут быть значениями или выражениями, результатом которых является значение. Все элементы списка должны быть одного типа.

Синтаксис функции

MIN(аргумент1)

Аргументы

аргумент1: список, состоящий из значений типа число (number), длительность (duration) или дата/время (datetime).

Возвращает

Тип возвращаемого значения тот же, что и у элементов списка, являющегося аргументом.

Описание

Использует в качестве аргумента значение логического типа (boolean) или выражение, результатом которого является значение логического типа. Выполняет операцию логического отрицания над аргументом.

Синтаксис функции

NOT(аргумент1)

Аргументы

аргумент1: логическое значение

Возвращает

логическое значение

Описание

Используются два аргумента одного типа: список в качестве аргумента1 и значение в качестве аргумента2. Возвращает логическое значение истина (true), если аргумент2 не содержится в списке аргумента1, в противном случае возвращает результат ложь (false).

Синтаксис функции

NOTCONTAINS(аргумент1, аргумент2)

Аргументы

аргумент1: список

аргумент2: значение типа число (number), длительность (duration) или дата/время (datetime).

Возвращает

логическое значение

Описание

Сравнивает два аргумента и возвращает логическое значение истина (true), если аргумент1 не равен аргументу2, в противном случае возвращает результат ложь (false).

Синтаксис функции

NOTEQUALS(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение любого типа.

Возвращает

логическое значение

Описание

Использует в качестве аргументов строку (string) и регулярное выражение. Возвращает логическое значение истина (true), если ни какая-либо часть строки, ни строка полностью не соответствуют условию, заданному регулярным выражением. В противном случае возвращает результат ложь (false).

Синтаксис функции

NOTMATCHES(аргумент1, аргумент2)

Аргументы

аргумент1: строка

аргумент2: регулярное выражение

Возвращает

логическое значение

Описание

Возвращает текущие дату и время.

Синтаксис функции

NOW

Аргументы

аргументы не требуются

Возвращает

текущие дата и время

Описание

Логический оператор ""ИЛИ"" использует в качестве аргументов два значения логического типа (boolean) или выражения, результатом которых являются значения логического типа. Оператор возвращает логическое значение истина (true), если один или оба аргумента являются истиной, в противном случае возвращает результат ложь (false).

Синтаксис функции

OR(аргумент1, аргумент2)

Аргументы

аргумент1, аргумент2: значение логического типа (boolean) или выражение, результатом которого является значение логического типа.

Возвращает

логическое значение

Описание

Использует в качестве аргументов два значения числового типа и возвращает результат умножения одного на другое.

Синтаксис функции

PRODUCT(аргумент1, аргумент2)

Аргументы

аргумент1: число

аргумент2: число

Возвращает

число

Описание

Использует в качестве аргументов два значения числового типа и возвращает целочисленный результат деления одного на другое.

Синтаксис функции

QUOTIENT(аргумент1, аргумент2)

Аргументы

аргумент1 (делимое): число

аргумент2 (делитель): число

Возвращает

целое число

Описание

Использует в качестве аргументов два значения числового типа и возвращает остаток от деления одного значения на другое.

Синтаксис функции

REMAINDER(аргумент1, аргумент2)

Аргументы

аргумент1 (делимое): число

аргумент2 (делитель): число

Возвращает

число

Описание

Округляет число до ближайшего целого числа.

Синтаксис функции

ROUND(аргумент1)

Аргументы

аргумент1

Возвращает

число

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает дату и время начала дня, в пределах которого находится значение аргумента.

Синтаксис функции

STARTOFDAY(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

дата/время (datetime)

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает дату и время начала недели, в пределах которой находится значение аргумента.

Синтаксис функции

STARTOFWEEK(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

дата/время (datetime)

Описание

Использует в качестве аргумента значение типа дата/время (datetime) и возвращает дату и время начала месяца, в пределах которого находится значение аргумента.

Синтаксис функции

STARTOFMONTH(аргумент1)

Аргументы

аргумент1: дата/время (datetime)

Возвращает

дата/время (datetime)

Описание

Вычитает значение аргумента2 из значения аргумента1.

Синтаксис функции

SUBTRACT(аргумент1, аргумент2)

Аргументы

Возвращает

Описание

Суммирует все значения списка, используемого в качестве аргумента. Конкатенация строк не поддерживается.

Синтаксис функции

SUM(аргумент1)

Аргументы

аргумент1: список, состоящий из значений типачисло (number), длительность (duration) или дата/время (datetime).

Возвращает

Тип возвращаемого значения тот же, что и у элементов списка, являющегося аргументом.

Описание

Возвращает дату и время на основании количества рабочих часов с определенного момента времени, с поправкой на праздники и фактические выходные дни.

Если временная зона рабочего офиса отличается от зоны сервера Comindware Tracker, используйте функцию WORKHOURSTZ ().

Синтаксис функции

WORKHOURS(аргумент1, аргумент2, аргумент3, аргумент4, list (аргумент5, аргумент6, .., аргументM)).

Аргументы

аргумент1: дата и время начала работы, аргумент2: количество рабочих часов, аргумент3: время начала рабочего дня, аргумент4: длительность рабочего дня (должна быть меньше разницы между 24 ч и временем начала рабочего дня), аргумент5, аргумент6, .., аргументM (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим.

Возвращает

Дата и время.

Описание

Возвращает дату и время на основании количества рабочих часов с определенного момента времени, с поправкой на праздники и фактические выходные дни, а также на временную зону рабочего офиса.

Синтаксис функции

WORKHOURSTZ(аргумент1, аргумент2, аргумент3, аргумент4, list (аргумент5, аргумент6, .., аргументM), аргументN)

Аргументы

аргумент1: дата и время начала работы, аргумент2: количество рабочих часов, аргумент3: время начала рабочего дня, аргумент4: длительность рабочего дня (должна быть меньше разницы между 24 ч и временем начала рабочего дня), аргумент5, аргумент6, .., аргументM (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим, аргументN: временная зона рабочего офиса в формате olson db.

Возвращает

Дата и время.

Описание

Возвращает дату на основании количества рабочих дней с определенной даты, с поправкой на праздники и фактические выходные дни.

Если временная зона рабочего офиса отличается от зоны сервера Comindware Tracker, используйте функцию WORKDAYSTZ ().

Синтаксис функции

WORKDAYS(аргумент1, аргумент2, list (аргумент3, аргумент4, .., аргументM))

Аргументы

аргумент1: дата и время начала работы, аргумент2: количество рабочих дней, аргумент3, аргумент4, .., аргументM (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим.

Возвращает

Дата.

Описание

Возвращает дату на основании количества рабочих дней с определенной даты, с поправкой на праздники и фактические выходные дни, а также на временную зону рабочего офиса.

Синтаксис функции

WORKDAYSTZ(аргумент1, аргумент2, list (аргумент3, аргумент4, .., аргументM), аргументN)

Аргументы

аргумент1: дата и время начала работы, аргумент2: количество рабочих дней, аргумент3, аргумент4, .., аргументM (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим, аргументN: временная зона рабочего офиса в формате olson db.

Возвращает

Дата.