В данном разделе приведен синтаксис и использование функций в языке формул Comindware.
| ADD() | |
|---|---|
| Описание | Суммирует два значения. Конкатенация строк не поддерживается. |
| Синтаксис | ADD(argument1, argument2) |
| Аргументы | argument1: число, argument2: число argument1: длительность, argument2: длительность argument1: дата и время, argument2: длительность |
| Возвращает | число длительность дата/время |
| ALL() | |
| Описание | Берет список логических переменных и возвращает значение Истина, если все логические переменные принимают значение Истина. |
| Синтаксис | ALL(argument1) |
| Аргументы | argument1: список логических переменных, или список выражений, результатом которых являются значения логического типа. |
| Возвращает | значение логического типа |
| AND() | |
| Описание | Берет два значения логического типа или два выражения, результатом которых являются значения логического типа, и возвращает результат логического умножения этих значений. |
| Синтаксис | AND(argument1, argument2) |
| Аргументы | argument1, argument2: значение логического типа или выражение, результатом которого является значение логического типа. |
| Возвращает | значение логического типа |
| ANY() | проверка на непустую последовательность |
| Описание | Проверяет список на не пустоту. По условию выборки формирует последовательность значений любого типа и проверяет её на не пустоту. |
| Синтаксис | ANY(list), ANY((sequence)) Для задания последовательности используйте стандартный запрос from where select. Пример: ANY( from I in db->Tickets where i->product = ‘Data Monsoon’ select i->name). Данное выражение вернет значение Истина, если хотя бы один элемент имеет значение предиката product равным «Data Monsoon». |
| Аргументы | list: список значений любого типа sequence: условие выборки |
| Возвращает | значение логического типа |
| ANY() | проверка предиката |
| Описание | Формирует выборку элементов и проверяет, что в ней есть хотя бы один элемент с истинным значением заданного предиката. |
| Синтаксис | ANY([(argument1), argument2, argument3]) Пример: ANY([(from I in db->Tickets where i->product==’Data Monsoon’ select i), i, i->NeedsQAHelp]) Данное выражение вернет значение Истина, если поступил хотя бы один запрос по продукту Data Monsoon, при обработке которого потребуется участие отдела QA. |
| Аргументы | argument1: запрос типа from where select, который возвращает последовательность элементов. argument2: локальная переменная, используемая в запросе. argument3: логическое утверждение об элементе последовательности, результатом которого является значение логического типа. |
| Возвращает | значение логического типа |
| AVERAGE() | |
| Описание | Возвращает среднее арифметическое аргументов. |
| Синтаксис | AVERAGE(argument1, argument2) |
| Аргументы | argument1, argument2: число |
| Возвращает | число |
| CEILING() | |
| Описание | Округляет число в большую сторону. |
| Синтаксис | CEILING(argument1) |
| Аргументы | argument1: число |
| Возвращает | число |
| CENTURY() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее веку указанной даты в местном часовом поясе. |
| Синтаксис | CENTURY(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| CONCAT() | |
| Описание | Берет список строк и объединяет их в новую строку. Возвращает данную строку. |
| Синтаксис | CONCAT(LIST(string1, string2, …, string N)) |
| Аргументы | LIST(string1, string2, …, string N): список строк. |
| Возвращает | строка |
| CONTAINS() | |
| Описание | Берет два аргумента одного типа: список строк и значение. Возвращает Истина, если аргумент 2 является частью списка аргумента 1, иначе возвращает Ложь. |
| Синтаксис | CONTAINS(argument1, argument2) |
| Аргументы | argument1: список строк argument2: строка (если в строке присутствуют кавычки, то необходимо помещать эту строку в кавычки другого типа (например,'\"слово"\')) |
| Возвращает | значение логического типа |
| COUNT() | |
| Описание | Возвращает количество элементов в списке. |
| Синтаксис | COUNT(argument1) |
| Аргументы | argument1: список строк |
| Возвращает | число |
| DATETIMEFROMSECONDS() | |
| Описание | Конвертирует заданное количество секунд в дату. |
| Синтаксис | DATETIMEFROMSECONDS(argument1) |
| Аргументы | argument1: число |
| Возвращает | дата/время |
| DATETIMEINSECONDS() | |
| Описание | Конвертирует заданную в качестве аргумента дату в количество секунд, прошедшее с 00:00:00 1 января 1970 года (Unix-время). |
| Синтаксис | DATETIMEINSECONDS(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| DAY() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее дню месяца указанной даты в местном часовом поясе. |
| Синтаксис | DAY(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| DAYTZ() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее дню месяца указанной даты в заданном часовом поясе. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA. |
| Синтаксис | DAYTZ(argument1, argument2) |
| Аргументы | argument1: дата/время argument2: строка |
| Возвращает | число |
| DIVIDE() | |
| Описание | Берет в качестве аргументов два значения числового типа и возвращает результат деления одного на другое. |
| Синтаксис | DIVIDE(argument1, argument2) |
| Аргументы | argument1 (делимое): число argument2 (делитель): число |
| Возвращает | число |
| DURATIONFROMSECONDS() | |
| Описание | Конвертирует заданное количество секунд в длительность. |
| Синтаксис | DURATIONFROMSECONDS(argument1) |
| Аргументы | argument1: число |
| Возвращает | длительность |
| DURATIONINSECONDS() | |
| Описание | Конвертирует заданную длительность в количество секунд. |
| Синтаксис | DURATIONINSECONDS(argument1) |
| Аргументы | argument1: длительность |
| Возвращает | число |
| EMPTY() | |
| Описание | Берет в качестве аргумента выражение, результатом которого является некоторое значение, и проверяет данное значение на пустоту. |
| Синтаксис | EMPTY(argument1) |
| Аргументы | argument1: значение, являющееся результатом выражения, заданного в качестве аргумента, и имеющее один с ним тип. |
| Возвращает | значение логического типа |
| ENDOFDAY() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время окончания дня, в пределах которого находится значение аргумента. |
| Синтаксис | ENDOFDAY(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| ENDOFMONTH() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время окончания месяца, в пределах которого находится значение аргумента. |
| Синтаксис | ENDOFMONTH(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| ENDOFQUARTER() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время окончания квартала, в пределах которого находится значение аргумента. |
| Синтаксис | ENDOFQUARTER(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| ENDOFWEEK() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время окончания недели, в пределах которого находится значение аргумента. |
| Синтаксис | ENDOFWEEK(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| ENDOFYEAR() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время окончания года, в пределах которого находится значение аргумента. |
| Синтаксис | ENDOFYEAR(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| ENDSWITH() | |
| Описание | Сравнивает два аргумента и возвращает значение Истина, если значение аргумента1 оканчивается на значение аргумента2, в противном случае возвращает Ложь. |
| Синтаксис | ENDSWITH(argument1, argument2) |
| Аргументы | argument1, argument2: строка |
| Возвращает | значение логического типа |
| ENUMVALUE() | |
| Описание |
Находит ID значения атрибута типа «Список значений» по системным именам атрибута и значения. |
| Синтаксис | ENUMVALUE("AttributeSystemName", "ValueSystemName") |
| Аргументы |
|
| Возвращает | Строку с ID искомого значения атрибута. |
| Пример |
Атрибут типа «Список значений» хранит ID своего текущего значения. Поэтому в формуле функция |
| EQUALS() | |
| Описание | Сравнивает два аргумента и возвращает значение Истина, если аргумент1 равен аргументу2, в противном случае возвращает результат Ложь. |
| Синтаксис | EQUALS() |
| Аргументы | argument1, argument2: значение любого типа |
| Возвращает | значение логического типа |
| FIRSTORDEFAULT() | |
| Описание | Возвращает либо первый элемент последовательности, либо значение по умолчанию для этого типа данных, если первый элемент последовательности не был определён. |
| Синтаксис | FIRSTORDEFAULT(sequence) Для задания последовательности используйте стандартный запрос from where select. Например, FIRSTORDEFAULT((from i in db->music where i>album == ‘Whale Meditation’ select i->song)). Данное выражение вернет первую песню из альбома Песни китов. |
| Аргументы | sequence: последовательность однородных элементов любого типа |
| Возвращает | тип возвращаемого значения совпадает с типом элементов последовательности |
| FLOOR() | |
| Описание | Округляет число в меньшую сторону. |
| Синтаксис | FLOOR(argument1) |
| Аргументы | argument1: число |
| Возвращает | число |
| FORMAT() | |
| Описание | Выполняет форматирование аргументов в соответствии с заданным шаблоном и возвращает отформатированную строку. |
| Синтаксис | FORMAT(строка задания формата, LIST(argument0, argument1, ..., argument N)) Формат для argument0 задается частью строки, обозначенной как {0}. Формат для argument1 определяется частью строки {1} и так далее. Аргументы должны быть записаны в следующем виде: LIST(argument0, argument1, ..., argument N). Также возможно использование функции FORMAT() для конкатенации строк. Например, FORMAT("{0}, {1}", LIST($title,$assignee)). |
| Аргументы | строка задания формата: строка argument0, argument1, ..., argument N: значения любого типа. |
| Возвращает | строка |
| GREATER() | |
| Описание | Возвращает логическое значение Истина, если аргумент1 больше аргумента2, в противном случае возвращает результат Ложь. |
| Синтаксис | GREATER(argument1, argument2) |
| Аргументы | argument1, argument2: значение логического типа, типа число, строка или дата/время. |
| Возвращает | значение логического типа |
| GREATEREQ() | |
| Описание | Возвращает логическое значение Истина, если аргумент1 больше либо равен аргументу2, в противном случае возвращает результат Ложь. |
| Синтаксис | GREATEREQ(argument1, argument2) |
| Аргументы | argument1, argument2: значение логического типа, типа число, строка или дата/время. |
| Возвращает | значение логического типа |
| HOUR() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее часу указанной даты в местном часовом поясе. |
| Синтаксис | HOUR(argument1) |
| Аргументы | argument1: дата и время |
| Возвращает | число |
| HOURTZ() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее часу указанной даты в заданном часовом поясе. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA. |
| Синтаксис | HOURTZ(argument1, argument2) |
| Аргументы | argument1: дата и время argument2: строка |
| Возвращает | число |
| ID() | |
| Описание | Преобразует строку с ID объекта в его идентификатор. |
| Синтаксис | ID("ObjectID") |
| Аргументы | ObjectID: строка, системное имя объекта. |
| Возвращает | ID объекта |
| Пример |
|
| IF() | |
| Описание | Использует в качестве аргументов значения или выражения, результатом которых является некоторое значение. Возвращает аргумент2, если аргумент1 является Истиной, в противном случае возвращает аргумент3. |
| Синтаксис | IF(argument1, argumen2, argument3) |
| Аргументы | argument1: значение логического типа или выражение, результатом которого является значение логического типа. argument2, argument3: значение любого типа или выражение, результатом которого является значение любого типа. |
| Возвращает | Тип возвращаемого значения тот же, что у аргументов argument2 и argument3 |
| INDEXOF() | |
| Описание | Возвращает номер (отсчитываемый от нуля) позиции, на которой располагается искомая строка в исходной строке. Номер позиции может отсчитываться от произвольного положения (опционально). |
| Синтаксис | INDEXOF(argument1, argument2, [опциональный argument3]) |
| Аргументы | argument1: исходная строка, argument2: искомая строка, argument3 (опционально): номер позиции, от которой производится отсчет |
| Возвращает | число |
| INSECONDS() | |
| Описание | Конвертирует значение длительности в секунды и наоборот. |
| Синтаксис | INSECONDS(argument1) |
| Аргументы | argument1: длительность argument 1: число |
| Возвращает | число, если в качестве аргумента используется значение длительности длительность, если в качестве аргумента используется число |
| ISOFORMAT() | |
| Описание | Конвертирует значение типа дата/время в формат ISO. |
| Синтаксис | ISOFORMAT(argument1) |
| Аргументы | argument1: дата и время |
| Возвращает | строка |
| ISTODAY() | |
| Описание | Возвращает значение Истина, если задана сегодняшняя дата. В противном случае возвращает результат Ложь. |
| Синтаксис | ISTODAY(аргумент1) |
| Аргументы | аргумент1: дата и время |
| Возвращает | значение логического типа |
| JOIN() | |
| Описание | Объединяет строки с использованием заданного разделителя. |
| Синтаксис | JOIN(argument1, list(argument2, argument3,.. argument N)) |
| Аргументы | argument1: разделитель объединяемых строк, argument2, argument3, ..., argument N (в функции list): объединяемые строки |
| Возвращает | строка |
| LENGTH() | |
| Описание | Возвращает количество символов в строке. |
| Синтаксис | LENGTH(argument1) |
| Аргументы | argument1: строка |
| Возвращает | число |
| LESS() | |
| Описание | Возвращает логическое значение Истина, если аргумент1 меньше аргумента2, в противном случае возвращает результат Ложь. |
| Синтаксис | LESS(argument1, argument2) |
| Аргументы | argument1, argument2: значение логического типа, число, строка или дата/время. |
| Возвращает | значение логического типа |
| LESSEQ() | |
| Описание | Возвращает логическое значение Истина, если аргумент1 меньше либо равен аргументу2, в противном случае возвращает результат Ложь. |
| Синтаксис | LESSEQ(argument1, argument2) |
| Аргументы | argument1, argument2: значение логического типа, число, строка или дата/время.. |
| Возвращает | значение логического типа |
| LIST() | |
| Описание | Определяет список. Берет перечисление значений одного типа, разделяет их запятыми и возвращает список. |
| Синтаксис | LIST(argument1, …, argument N) |
| Аргументы | argument1, …, argument N: значения одного типа |
| Возвращает | список |
| MAKEDATETIME() | |
| Описание | Возвращает дату и время в местном часовом поясе, соответствующие указанным значениям года, месяца, дня, часа, минут и секунд. |
| Синтаксис | MAKEDATETIME(argument1, argument2, argument3, argument4, argument5, argument6) |
| Аргументы | argument1: числовое значение, соответствующее году. argument2: числовое значение, соответствующее месяцу. argument3: числовое значение, соответствующее дню. argument4: числовое значение, соответствующее часу. argument5: числовое значение, соответствующее минутам. argument6: числовое значение, соответствующее секундам. |
| Возвращает | дата/время |
| MAKEDATETIMETZ() | |
| Описание | Возвращает дату и время в заданном часовом поясе, соответствующие указанным значениям года, месяца, дня, часа, минут и секунд. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA |
| Синтаксис | MAKEDATETIMETZ(argument1, argument2, argument3, argument4, argument5, argument6, argument7) |
| Аргументы | аргумент1: числовое значение, соответствующее году. аргумент1: числовое значение, соответствующее месяцу. аргумент3: числовое значение, соответствующее дню. аргумент4: числовое значение, соответствующее часу. аргумент5: числовое значение, соответствующее минутам. аргумент6: числовое значение, соответствующее секундам. аргумент7: строка, соответствующая идентификатору часового пояса |
| Возвращает | дата/время |
| MATCHES() | |
| Описание | Использует в качестве аргументов строку и регулярное выражение. Возвращает логическое значение Истина, если какая-либо часть строки или строка полностью соответствует условию, заданному регулярным выражением. В противном случае возвращает результат Ложь. |
| Синтаксис | MATCHES(argument1, argument2) |
| Аргументы | argument1: строка argument2: строка (регулярное выражение) |
| Возвращает | значение логического типа |
| MAX() | |
| Описание | Определяет максимальное значение при помощи функции GREATER среди всех элементов списка, заданного в качестве аргумента. Элементы списка могут быть значениями или выражениями, результатом которых является значение. Все элементы списка должны быть одного типа. |
| Синтаксис | MAX(argument1) |
| Аргументы | argument1: список, состоящий из значений типа число, длительность или дата/время. |
| Возвращает | Тип возвращаемого значения тот же, что и у элементов списка. Являющегося аргументом. |
| MIN() | |
| Описание | Определяет минимальное значение при помощи функции LESS среди всех элементов списка, заданного в качестве аргумента. Элементы списка могут быть значениями или выражениями, результатом которых является значение. Все элементы списка должны быть одного типа. |
| Синтаксис | MIN(argument1) |
| Аргументы | argument1: список, состоящий из значений типа число, длительность или дата/время. |
| Возвращает | Тип возвращаемого значения тот же, что и у элементов списка, являющегося аргументом. |
| MINUTE() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее минуте указанной даты в местном часовом поясе. |
| Синтаксис | MINUTE(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| MINUTETZ() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее минуте указанной даты в заданном часовом поясе. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA. |
| Синтаксис | MINUTETZ(argument1, argument2) |
| Аргументы | argument1: дата/время argument2: строка |
| Возвращает | число |
| MONTH() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее месяцу указанной даты в местном часовом поясе. |
| Синтаксис | MONTH(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| MONTHTZ() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее месяцу указанной даты в заданном часовом поясе. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA. |
| Синтаксис | MONTHTZ(argument1, argument2) |
| Аргументы | argument1: дата/время argument2: строка |
| Возвращает | число |
| NOT() | |
| Описание | Использует в качестве аргумента значение логического типа или выражение, результатом которого является значение логического типа. Выполняет операцию логического отрицания над аргументом. |
| Синтаксис | NOT(argument1) |
| Аргументы | argument1: логический |
| Возвращает | значение логического типа |
| NOTEQUALS() | |
| Описание | Сравнивает два аргумента и возвращает логическое значение Истина, если аргумент1 не равен аргументу2, в противном случае возвращает результат Ложь. |
| Синтаксис | NOTEQUALS(argument1, argument2) |
| Аргументы | argument1, argument2: значение любого типа |
| Возвращает | значение логического типа |
| NOTMATCHES() | |
| Описание | Использует в качестве аргументов строку и регулярное выражение. Возвращает логическое значение Истина, если часть строки или строка полностью не соответствуют условию, заданному регулярным выражением. В противном случае возвращает результат Ложь. |
| Синтаксис | NOTMATCHES(argument1, argument2) |
| Аргументы | argument1: строка argument2: строка (регулярное выражение) |
| Возвращает | значение логического типа |
| NOW() | |
| Описание | Возвращает текущую дату и время |
| Синтаксис | NOW() |
| Аргументы | аргументы не требуются |
| Возвращает | текущую дату и время |
| OBJECT() | |
| Описание | Поиск записи шаблона, в которой атрибут имеет указанное значение |
| Синтаксис | OBJECT(argument1, argument2, argument3, argument4) |
| Аргументы |
Строковые литералы в аргументах следует заключать в кавычки. |
| Возвращает | ID записи |
| OR() | |
| Описание | Берет два значения логического типа или два выражения, результатом которых являются значения логического типа, и возвращает результат логического сложения этих значений. |
| Синтаксис | OR(argument1, argument2) |
| Аргументы | argument1, argument2: значение логического типа или выражение, результатом которого является значение логического типа. |
| Возвращает | значение логического типа |
| PRODUCT() | |
| Описание | Берет в качестве аргументов два значения числового типа и возвращает результат умножения одного на другое. |
| Синтаксис | PRODUCT(argument1, argument2) |
| Аргументы | argument1: число argument2: число |
| Возвращает | число |
| QUOTIENT() | |
| Описание | Использует в качестве аргументов два значения числового типа и возвращает целочисленный результат деления одного на другое. |
| Синтаксис | QUOTIENT(argument1, argument2) |
| Аргументы | argument1(делимое): число argument2(делитель): число |
| Возвращает | целое число |
| REGEXREPLACE() | |
| Описание | Принимает исходную строку sourceString, находит в ней подстроки по регулярному выражению (шаблону) regEx, заменяет найденные подстроки замещающей строкой replacementString и возвращает результирующую строку. Инструмент отладки регулярных выражений со справкой: https://regex101.com/ |
| Синтаксис | REGEXREPLACE(sourceString, regEx, replacementString) |
| Аргументы |
|
| Возвращает | строку |
| Пример |
|
| REMAINDER() | |
| Описание | Использует в качестве аргументов два значения числового типа и возвращает остаток от деления одного значения на другое. |
| Синтаксис | REMAINDER(argument1, argument2) |
| Аргументы | argument1(делимое): число argument2(делитель): число |
| Возвращает | число |
| REPLACE() | |
| Описание | Заменяет все экземпляры заданной строки в исходной строке на новое значение. |
| Синтаксис | REPLACE(argument1, argument2, argument3) |
| Аргументы | argument1: исходная строка argument2: заменяемая строка argument3: новая строка |
| Возвращает | строка |
| ROUND() | |
| Описание | Округляет число к ближайшему целому числу. |
| Синтаксис | ROUND(argument1) |
| Аргументы | argument1: число |
| Возвращает | число |
| SECOND() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее секундам указанной даты в местном часовом поясе. |
| Синтаксис | SECOND(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| SECONDTZ() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее секундам указанной даты в заданном часовом поясе. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA. |
| Синтаксис | SECONDTZ(argument1, argument2) |
| Аргументы | argument1: дата/время argument2: строка |
| Возвращает | число |
| STARTOFDAY() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время начала дня, в пределах которого находится значение аргумента. |
| Синтаксис | STARTOFDAY(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| STARTOFMONTH() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время начала месяца, в пределах которого находится значение аргумента. |
| Синтаксис | STARTOFMONTH(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| STARTOFQUARTER() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время начала квартала, в пределах которого находится значение аргумента. |
| Синтаксис | STARTOFQUARTER(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| STARTOFWEEK() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время начала недели, в пределах которой находится значение аргумента. |
| Синтаксис | STARTOFWEEK(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| STARTOFYEAR() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает дату и время начала года, в пределах которой находится значение аргумента. |
| Синтаксис | STARTOFYEAR(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | дата/время |
| STARTSWITH() | |
| Описание | Сравнивает два аргумента и возвращает значение Истина, если значение аргумента1 начинается с значения аргумента2, в противном случае возвращает Ложь. |
| Синтаксис | STARTWITH(argument1, argument2) |
| Аргументы | argument1, argument2: строка |
| Возвращает | значение логического типа |
| SUBSTRING() | |
| Описание | Извлекает из строки подстроку определенной длины начиная с заданной позиции (задание длины опционально). |
| Синтаксис | SUBSTRING(argument1, argument2, [опциональный argument3]) |
| Аргументы | argument1: строка argument2: номер позиции подстроки (отсчитываемый от нуля) argument 3(опционально): количество символов в подстроке |
| Возвращает | строка |
| SUBTRACT() | |
| Описание | Вычитает значение аргумента2 из значения аргумента1. |
| Синтаксис | SUBTRACT(argument1, argument2) |
| Аргументы | argument1: число; argument2: число argument1: длительность; argument2: длительность argument1: дата и время; argument2: длительность. argument1: дата и время; argument2: дата и время |
| Возвращает | число длительность дата/время длительность |
| SUM() | |
| Описание | Суммирует все значения списка, используемого в качестве аргумента. Конкатенация строк не поддерживается. |
| Синтаксис | SUM(argument1) |
| Аргументы | argument1: список, состоящий из значений типа число или длительность |
| Возвращает | тип возвращаемого значения тот же, что и у элементов списка, являющегося аргументом |
| TOLOWER() | |
| Описание | Переводит строку в нижний регистр (к прописным буквам). |
| Синтаксис | TOLOWER(argument1) |
| Аргументы | argument1: строка |
| Возвращает | строка |
| TOUPPER() | |
| Описание | Переводит строку в верхний регистр (к заглавным буквам). |
| Синтаксис | TOUPPER(argument1) |
| Аргументы | argument1: строка |
| Возвращает | строка |
| USER() | |
| Описание | Возвращает текущего пользователя или идентификатор текущего пользователя, в зависимости от того, к какому типу данных относится поле. Если вычисляемый атрибут принадлежит типу данных Пользователь, функция возвращает текущего пользователя. Если вычисляемый атрибут текстового типа, функция возвращает идентификатор текущего пользователя. |
| Синтаксис | USER() |
| Аргументы | аргументы не требуются |
| Возвращает | пользователь или строка |
| WORKDAYS() | |
| Описание | Возвращает дату на основании количества рабочих дней с определенной даты, с поправкой на праздники и фактические выходные дни. Если временная зона рабочего офиса отличается от зоны сервера Comindware, используйте функцию WORKDAYSTZ(). |
| Синтаксис | WORKDAYS(argument1, argument2, [опционально list (argument3, argument4, ..., argument M)]) |
| Аргументы | argument1: дата/время начала работы, argument2: количество рабочих дней, argument3, argument4, …, argument M (в опциональной функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим. |
| Возвращает | дата/время |
| WORKDAYSTZ() | |
| Описание | Возвращает дату на основании количества рабочих дней с определенной даты, с поправкой на праздники и фактические выходные дни, а также на временную зону рабочего офиса. |
| Синтаксис | WORKDAYSTZ(argument1, argument2, list (argument3, argument4, .., argument M), argument N) |
| Аргументы | argument1: дата и время начала работы argument2: количество рабочих дней argument3, argument4, …, argument M (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим argument N: временная зона рабочего офиса в формате olson db |
| Возвращает | дата/время |
| WORKDAYSDURATION() | |
| Описание | Возвращает продолжительность работы между двумя датами, на основании предположения, что рабочий день начинается в 00:00 и длится 24 часа. Если временная зона рабочего офиса отличается от зоны сервера Comindware, используйте функцию WORKDAYSDURATIONTZ (). |
| Синтаксис | WORKDAYSDURATION(argument1, argument 2, [опционально list (argument3, argument4, …, argument M)]) |
| Аргументы | argument1: дата и время начала работы, argument2: дата и время окончания работы, argument3, argument4, …, argument M (в опциональной функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим. |
| Возвращает | длительность |
| WORKDAYSDURATIONTZ() | |
| Описание | Возвращает продолжительность работы между двумя датами с поправкой на временную зону рабочего офиса, на основании предположения, что рабочий день начинается в 00:00 и длится 24 часа. |
| Синтаксис | WORKDAYSDURATIONTZ(argument1, argument2, list (argument3, Argument4, .., argument M), argument N) |
| Аргументы | argument1: дата и время начала работы, argument2: дата и время окончания работы, argument3, argument4, …, argument M (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим, argument N: временная зона рабочего офиса в формате olson db. |
| Возвращает | длительность |
| WORKHOURS() | |
| Описание | Возвращает дату и время на основании количества рабочих часов с определенного момента времени, с поправкой на праздники и фактические выходные дни. Если временная зона рабочего офиса отличается от зоны сервера Comindware, используйте функцию WORKHOURSTZ (). |
| Синтаксис | WORKHOURS(argument1, argument2, argument3, argument 4, [опционально list (argument5, argument6, .., argument M)]) |
| Аргументы | argument1: дата/время начала работы, argument2: количество рабочих часов, argument3: время начала рабочего дня, argument4: длительность рабочего дня (должна быть меньше разницы между 24 ч и временем начала рабочего дня), argument5, argument6, … argument M (в опциональной функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим. |
| Возвращает | дата/время |
| WORKHOURSDURATION() | |
| Описание | Возвращает продолжительность работы между двумя датами при условии, что рабочий день начинается в заданное время и имеет определенную длительность. Если временная зона рабочего офиса отличается от зоны сервера Comindware, используйте функцию WORKHOURSDURATIONTZ (). |
| Синтаксис | WORKHOURSDURATION(argument1, argument2, argument3, argument 4, [опционально list (argument5, argument6, .., argument M)]) |
| Аргументы | argument1: дата/время начала работы argument2: дата/время окончания работы argument3: время начала рабочего дня argument4: длительность рабочего дня (должна быть меньше разницы между 24 ч и временем начала рабочего дня) argument5, argument6, .., argument M (в опциональной функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим. |
| Возвращает | длительность |
| WORKHOURSDURATIONTZ() | |
| Описание | Возвращает продолжительность работы между двумя датами с поправкой на временную зону рабочего офиса, при условии, что рабочий день начинается в заданное время и имеет определенную длительность. |
| Синтаксис | WORKHOURSDURATIONTZ(argument1, argument2, argument3, argument4, list (argument5, argument6, .., argument M), argument N) |
| Аргументы | argument1: дата/время начала работы argument2: дата/время окончания работы argument3: время начала рабочего дня argument4: длительность рабочего дня (должна быть меньше разницы между 24 ч и временем начала рабочего дня) argument5, argument6, .., argument M(в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим argument N: временная зона рабочего офиса в формате olson db. |
| Возвращает | длительность |
| WORKHOURSTZ() | |
| Описание | Возвращает дату и время на основании количества рабочих часов с определенного момента времени, с поправкой на праздники и фактические выходные дни, а также на временную зону рабочего офиса. |
| Синтаксис | WORKHOURSTZ(argument1, argument2, argument3, argument4, list(argument5, argument6, .., argument M), argument N) |
| Аргументы | argument1: дата/время начала работы, argument2: количество рабочих часов, argument3: время начала рабочего дня, argument4: длительность рабочего дня (должна быть меньше разницы между 24 ч и временем начала рабочего дня), argument5, argument6, argument M (в функции list): праздники и исключения из выходных дней, т. е. если в списке указан рабочий день, он считается праздником, и наоборот, если в списке выходной день, он считается рабочим, argument N: временная зона рабочего офиса в формате olson db. |
| Возвращает | дата/время |
| YEAR() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее году указанной даты в местном часовом поясе. |
| Синтаксис | YEAR(argument1) |
| Аргументы | argument1: дата/время |
| Возвращает | число |
| YEARTZ() | |
| Описание | Использует в качестве аргумента значение типа дата/время и возвращает числовое значение, соответствующее году указанной даты в заданном часовом поясе. Идентификатор часового пояса должен быть задан в формате базы данных часовых поясов IANA. |
| Синтаксис | YEARTZ(argument1, argument2) |
| Аргументы | argument: дата/время argument: строка |
| Возвращает | число |
Номер Статьи: 4993
Размещено: Wed, Aug 23, 2023
Последнее обновление: Thu, Nov 28, 2024
Online URL: https://kb.comindware.ru/article/spisok-funkcij-yazyka-formul-comindware-4993.html