Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Последняя версия Следующая версия справа и слева
common_all:skd_functions [2018/08/28 12:08]
alexander
common_all:skd_functions [2018/08/28 12:09]
alexander
Строка 3: Строка 3:
 <​html><​h1>​Функции языка выражений системы компоновки данных</​span></​h1>​ <​html><​h1>​Функции языка выражений системы компоновки данных</​span></​h1>​
 </​html>​ </​html>​
 +
 +
 +1. Вычислить (Eval) - предназначена для вычисления выражения в контексте некоторой группировки. Функция используется для совместимости с предыдущими версиями платформы. Вместо неё рекомендуется использовать функцию ВычислитьВыражение.
 +
 +Синтаксис:​
 +Вычислить(Выражение,​ Группировка,​ ТипРасчета)
 +
 +Параметры: ​
 +Выражение (Строка). Cодержит вычисляемое выражение; ​
 +Группировка (Строка). Содержит имя группировки,​ в контексте которой необходимо вычислить выражение. В случае если в качестве имени группировки используется пустая строка,​ вычисление будет выполнено в контексте текущей группировки. В случае если в качестве имени группировки будет использована строка ОбщийИтог,​ вычисление будет выполнено в контексте общего итога. В остальных случаях вычисление будет выполняться в контексте родительской группировки с таким именем.
 +Например:​
 +Сумма(Продажи.СуммаОборот) / Вычислить("​Сумма(Продажи.СуммаОборот)",​ "​ОбщийИтог"​).
 +В данном примере в результате получится отношение суммы по полю "​Продажи.СуммаОборот"​ записи группировки к сумме того же поля во всей компоновке.
 +ТипРасчета (Строка). В случае если данный параметр имеет значение "​ОбщийИтог",​ выражение будет вычисляться для всех записей группировки. В случае если значение параметра "​Группировка",​ значения будут вычисляться для текущей групповой записи группировки.
 +
 +
 +2. ВычислитьВыражение (EvalExpression) - предназначена для вычисления выражения в контексте некоторой группировки. Функция учитывает отбор группировок,​ но не учитывает иерархические отборы. Функция не может применяться к группировке в групповом отборе этой группировки.
 +
 +Синтаксис:​
 +ВычислитьВыражение(Выражение,​ Группировка,​ ТипРасчета,​ Начало,​ Конец, Сортировка,​ ИерархическаяСортировка,​ ОбработкаОдинаковыхЗначенийПорядка)
 +
 +Параметры:​
 +Выражение (Строка). Содержит вычисляемое выражение;​
 +Группировка (Строка). Содержит имя группировки,​ в контексте которой необходимо вычислить выражение. В случае если в качестве имени группировки используется пустая строка,​ вычисление будет выполнено в контексте текущей группировки. В случае если в качестве имени группировки будет использована строка ОбщийИтог,​ вычисление будет выполнено в контексте общего итога. В остальных случаях вычисление будет выполняться в контексте родительской группировки с таким именем;​
 +ТипРасчета (Строка). В случае если данный параметр имеет значение "​ОбщийИтог",​ выражение будет вычисляться для всех записей группировки. В случае если значение параметра "​Группировка",​ значения будут вычисляться для текущей групповой записи группировки. Если параметр имеет значение "​ГруппировкаНеРесурса",​ то при вычислении функции для групповой записи по ресурсам,​ выражение будет вычислено для первой групповой записи исходной группировки. При вычислении функции ВычислитьВыражение со значением "​ГруппировкаНеРесурса"​ для групповых записей,​ не являющихся группировками по ресурсам,​ функция вычисляется так же, как бы она вычислялась со значением параметра "​Группировка"​. Компоновщик макета компоновки данных при генерации макета компоновки данных при выводе в макет поля – ресурса,​ по которому выполняется группировка,​ выдает в макет выражение,​ вычисляемое при помощи функции ВычислитьВыражение,​ с указанным параметром "​ГруппировкаНеРесурса"​. Для остальных ресурсов в группировке по ресурсу выдаются обычные выражения ресурсов. Если параметр имеет значение "​Иерархия",​ то выражение нужно вычислять для родительской иерархической записи,​ если таковая имеется,​ и для всей группировки,​ если родительской иерархической записи не имеется. Компоновщик макета при генерации выражения для поля "% в группе иерархии"​ генерирует выражение,​ содержащее отношение выражения ресурса к функции ВычислитьВыражение для выражения ресурса,​ вычисляемого для текущей группировки с типом вычисления "​Иерархия"​.
 +Начало. Указывает,​ с какой записи нужно начинать фрагмент,​ в котором рассчитывать агрегатные функции выражения и из какой записи получать значения полей вне агрегатных функций. Строка,​ содержащая одно из:
 +"​Первая"​ ("​First"​). Необходимо получать первую запись группировки. После слова в скобках можно указывать выражение,​ результат которого будет использоваться как смещение от начала группировки. Получаемое значение должно целым быть числом,​ больше нуля. Например,​ Первая(3) – получение третьей записи от начала группировки. Если первая запись выходит за пределы группировки,​ то считается,​ что записей нет. Например,​ если записей 3, а требуется получить Первая(4),​ то считается,​ что записей нет.
 +"​Последняя"​ ("​Last"​). Необходимо получить последнюю запись группировки. После слова в скобках можно указывать выражение,​ результат которого будет использоваться как смещение от конца группировки. Получаемое значение должно целым быть числом,​ больше нуля. Например,​ Последняя(3) – получение третьей записи от конца группировки. Если последняя запись выходит за пределы группировки,​ то считается,​ что записей нет. Например,​ если записей 3, а требуется получить Последняя(4),​ то считается,​ что записей нет.
 +"​Предыдущая"​ ("​Previous"​). Необходимо получить предыдущую запись группировки. После слова в скобках можно указывать выражение,​ результат которого будет использоваться как смещение назад от текущей записи группировки. Например,​ Предыдущая(2) – получение предыдущей от предыдущей записи. Если предыдущая запись выходит за пределы группировки (например,​ для второй записи группировки требуется получить Предыдущая(3)),​ то получается первая запись группировки. При получении предыдущей записи для итога по группировке считается,​ получается первая запись.
 +"​Следующая"​ ("​Next"​). Необходимо получить следующую запись группировки. После слова в скобках можно указывать выражение,​ результат которого будет использоваться как смещение вперед от текущей записи группировки. Например,​ Следующая(2) – получение следующей от следующей записи. Если следующая запись выходит за пределы группировки,​ то считается,​ что записей нет. Например,​ если записей 3 и для третьей записи получают Следующая,​ то считается,​ что записей нет. При получении следующей записи для итога по группировке считается,​ что записи нет.
 +"​Текущая"​ ("​Current"​). Необходимо получить текущую запись. При получении для итога по группировке получается первая запись.
 +"​ОграничивающееЗначение"​ ("​BoundaryValue"​). Необходимость получить запись по указанному значению. После слова ОграничивающееЗначение в скобках нужно указать выражение,​ со значения которого нужно начинать фрагмент,​ первого поля упорядочивания. В качестве записи будет получаться первая запись,​ значение поля упорядочивания у которой больше или равно указанному значению. Например,​ если в качестве поля упорядочивания используется поле Период,​ и оно имеет значения 01.01.2010, 01.02.2010, 01.03.2010, и требуется получить ОграничивающееЗначение(ДатаВремя(2010,​ 1, 15)), то будет получена запись с датой 01.02.2010.
 +Конец. Указывает,​ до какой записи нужно продолжать фрагмент,​ в котором рассчитывать агрегатное выражение. Строка,​ содержащая одно из:
 +"​Первая"​ ("​First"​).
 +"​Последняя"​ ("​Last"​).
 +"​Предыдущая"​ ("​Previous"​).
 +"​Следующая"​ ("​Next"​).
 +"​Текущая"​ ("​Current"​).
 +"​ОграничивающееЗначение"​ ("​BoundaryValue"​).
 +Сортировка. Строка,​ в которой перечисляются выражения,​ разделенные запятыми,​ в направлении которых нужно упорядочивать последовательность. Если не указана,​ то упорядочивание выполняется также как и у группировки,​ для которой вычисляется выражение. После каждого выражения можно указать ключевое слово Возр, для упорядочивания по возрастанию,​ Убыв, для упорядочивания по убывания,​ Автоупорядочивание,​ для упорядочивания ссылочных полей по полям, по которым нужно упорядочивать объект,​ на который выполняется ссылка. Слово Автоупорядочивание может использоваться как со словом Возр, так и со словом Убыв.
 +ИерархическаяСортировка. Аналогично сортировке. Применяется для упорядочивания иерархических записей. Если не указано,​ компоновщик макета генерирует упорядочивание в соответствии с упорядочиванием,​ указанным в параметре Сортировка.
 +ОбработкаОдинаковыхЗначенийПорядка. Строка,​ содержащее одно из:
 +"​Вместе"​ ("​Together"​) - обозначает,​ что для определения предыдущей и следующей записей используется последовательность упорядоченных записей;​
 +"​Отдельно"​ ("​Separately"​) - обозначает,​ что предыдущая и следующие записи определяются на основании значений выражений упорядочивания;​
 +Например,​ если полученная последовательность упорядочена по дате:
 +1. 01 января 2001 Иванов М. 10
 +2. 02 января 2001 Петров С. 20
 +3. 02 января 2001 Сидоров Р. 30
 +4. 03 января 2001 Петров С. 40
 +При использовании обработки одинаковых значений порядка "​Отдельно",​ предыдущей к записи 3 будет запись 2, а при использовании "​Вместе"​ - запись 1. А фрагментом для текущей записи к записи 2 для "​Отдельно"​ будет запись 2, а для "​Вместе"​ - записи 2 и 3. Таким образом,​ сумма по текущей записи для "​Отдельно"​ составит 20, а для "​Вместе"​ - 50. При указанном "​Вместе"​ в параметрах Начало и Конец нельзя указывать смещение для позиций "​Первая",​ "​Последняя",​ "​Предыдущая",​ "​Следующая"​. Значение по умолчанию "​Отдельно"​.
 +
 +Пример:​
 +Получение отношения суммы по полю "​Продажи.СуммаОборот"​ записи группировки к сумме того же поля во всей компоновке:​
 +Сумма(Продажи.СуммаОборот) / ВычислитьВыражение("​Сумма(Продажи.СуммаОборот)",​ "​ОбщийИтог"​).
 +
 +В данном примере вычисляется значение текущей иерархии:​
 +Выбор
 +    Когда Уровень() > 0
 +        Тогда ВычислитьВыражение("​Ссылка",​ , "​Иерархия"​)
 +    Иначе Null
 +Конец
 +
 +Примеры применения функции СКД - ВычислитьВыражение
 +
 +Примечания:​
 +Функция учитывает отбор группировок,​ но не учитывает иерархические отборы. Функция не может применяться к группировке в групповом отборе этой группировки. Например,​ в отборе группировки Номенклатура нельзя использовать выражение ВычислитьВыражение("​Сумма(СуммаОборот)",​ , "​ОбщийИтог"​) > 1000. Но такое выражение можно использовать в иерархическом отборе. Если конечная запись предшествует начальной,​ то считается,​ что записи для расчета детальных данных и расчета агрегатных функций отсутствуют. При расчете интервальных выражений для общего итога (параметр Группировка имеет значение "​ОбщийИтог"​) считается,​ что записи для расчета детальных данных и расчета агрегатных функций отсутствуют. Компоновщик макета при генерации выражения функции ВычислитьВыражение,​ в случае если выражение упорядочивания содержит поля, которые не могут быть использованы в группировке,​ заменяет функцию ВычислитьВыражение на NULL.
 +
 +3. ВычислитьВыражениеСГруппировкойМассив (EvalExpressionWithGroupArray) - функция возвращает массив,​ каждый элемент которого содержит результат вычисления выражения для группировки по указанному полю.
 +
 +Синтаксис:​
 +ВычислитьВыражениеСГруппировкойМассив (Выражение,​ ВыраженияПолейГруппировки,​ ОтборЗаписей,​ ОтборГруппировок)
 +
 +Параметры:​
 +Выражение (Строка) - выражение,​ которое нужно вычислить. Например,​ "​Сумма(СуммаОборот)";​
 +ВыраженияПолейГруппировки - выражения полей группировки,​ перечисленные через запятую. Например,​ "​Контрагент,​ Партия";​
 +ОтборЗаписей - выражение,​ применяемое к детальным записям. Например,​ "​ПометкаУдаления = Ложь"​. Если в данном параметре используется агрегатная функция,​ то при выполнении компоновки данных возникнет ошибка;​
 +ОтборГруппировок - отбор, применяемый к групповым записям. Например:​ "​Сумма(СуммаОборот) > &​Параметр1"​.
 +
 +Пример:​
 +Максимум(ВычислитьВыражениеСГруппировкойМассив ("​Сумма(СуммаОборот)",​ "​Контрагент"​));​
 +
 +Компоновщик макета при генерации макета преобразовывает параметры функции в термины полей макета компоновки данных. Например,​ поле Контрагент будет конвертировано в НаборДанных.Контрагент.
 +Компоновщик макета при генерации выражений для вывода пользовательского поля, в выражении которого присутствует только функция ВычислитьМассивСГруппировкой генерирует выводимое выражение таким образом,​ чтобы данные выводить представления и данные были упорядочены.
 +Например,​ для пользовательского поля с выражением:​
 +ВычислитьВыражениеСГруппировкойМассив("​Сумма(СуммаОборот)",​ "​Контрагент"​)
 +компоновщик макета сгенерирует для вывода следующее выражение:​
 +СоединитьСтроки(Массив(Упорядочить(ВычислитьВыражениеСГруппировкойТаблицаЗначений ("​Представление(Сумма(НаборДанных.СуммаОборот)),​ Сумма(НаборДанных.СуммаОборот)",​ "​НаборДанных.Контрагент"​),​ "​2"​)))
 +
 +4. ВычислитьВыражениеСГруппировкойТаблицаЗначений (EvalExpressionWithGroupValueTable) - функция возвращает таблицу значений,​ каждый элемент которого содержит результат вычисления выражения для группировки по указанному полю.
 +
 +Синтаксис:​
 +ВычислитьВыражениеСГруппировкойТаблицаЗначений (Выражение,​ ВыраженияПолейГруппировки,​ ОтборЗаписей,​ ОтборГруппировок)
 +
 +Параметры:​
 +Выражение (Строка) - выражение,​ которое нужно вычислить. В строке может быть перечислено несколько выражений через запятую. После каждого выражения может быть необязательное ключевое слово КАК и имя колонки таблицы значений. Например:​ "​Контрагент,​ Сумма(СуммаОборот) Как ОбъемПродаж"​.
 +ВыраженияПолейГруппировки - выражения полей группировки,​ перечисленные через запятую. Например,​ "​Контрагент,​ Партия";​
 +ОтборЗаписей - выражение,​ применяемое к детальным записям. Например,​ "​ПометкаУдаления = Ложь"​. Если в данном параметре используется агрегатная функция,​ то при выполнении компоновки данных возникнет ошибка;​
 +ОтборГруппировок - отбор, применяемый к групповым записям. Например:​ "​Сумма(СуммаОборот) > &​Параметр1"​.
 +
 +Пример:​
 +ВычислитьВыражениеСГруппировкойТаблицаЗначений ("​Контрагент КАК Контрагент,​ Сумма(СуммаОборот) Как ОбъемПродаж",​ "​Контрагент"​)
 +
 +Результатом работы данной функции будет таблица значений с колонками Контрагент и ОбъемПродаж,​ в которых будут находиться контрагенты с их объемами продаж.
 +Компоновщик макета при генерации макета преобразовывает параметры функции в термины полей макета компоновки данных. Например,​ поле Контрагент будет конвертировано в НаборДанных.Контрагент.
 +Например,​ пользовательского поля с выражением:​
 +ВычислитьВыражениеСГруппировкойТаблицаЗначений ("​Контрагент,​ Сумма(СуммаОборот)",​ "​Контрагент"​)
 +Компоновщик макета сгенерирует для вывода следующее выражение:​
 +СоединитьСтроки(ПолучитьЧасть(Упорядочить(ВычислитьВыражениеСГруппировкойТаблицаЗначений ("​НаборДанных.Контрагент,​ НаборДанных.КонтрагентПредставление,​ Сумма(НаборДанных.СуммаОборот),​ Представление(НаборДанных.СуммаОборот),​ НаборДанных.ПолеУпорядочивание",​ "​НаборДанных.Контрагент"​),​ "5, 1, 3"), "2, 4"))
 +
 +5. Уровень (Level) - функция предназначена для получения текущего уровня записи.
 +
 +Синтаксис:​
 +Уровень()
 +
 +Пример:​
 +Уровень()
 +
 +6. НомерПоПорядку (SequenceNumber) - получить следующий порядковый номер.
 +
 +Синтаксис:​
 +НомерПоПорядку()
 +
 +Пример:​
 +НомерПоПорядку()
 +
 +7. НомерПоПорядкуВГруппировке (SequenceNumberInGrouping) - возвращает следующий порядковый номер в текущей группировке.
 +
 +Пример:​
 +НомерПоПорядкуВГруппировке()
 +
 +8. Формат (Format) - получить отформатированную строку переданного значения.
 +
 +Синтаксис:​
 +Формат(Значение,​ ФорматнаяСтрока)
 +
 +Параметры:​
 +Значение - выражение,​ которое требуется отформатировать;​
 +ФорматнаяСтрока - форматная строка задается в соответствии с форматной строкой 1С:​Предприятие.
 +
 +Пример:​
 +Формат(РасходныеНакладные.СуммаДок,​ "​ЧДЦ=2"​)
 +
 +9. НачалоПериода (BeginOfPeriod) - функция предназначена для выделения определенной даты из заданной даты.
 +
 +Синтаксис:​
 +НачалоПериода(Дата,​ ТипПериода)
 +
 +Параметры:​
 +Дата (Дата). Заданная дата; ​
 +ТипПериода (Строка). Содержит одно из значений:​ Минута;​ Час; День; Неделя;​ Месяц; Квартал;​ Год; Декада;​ Полугодие.
 +
 +Пример:​
 +НачалоПериода(ДатаВремя(2002,​ 10, 12, 10, 15, 34), "​Месяц"​)
 +Результат:​ 01.10.2002 0:00:00
 +
 +10. КонецПериода (EndOfPeriod) - функция предназначена для выделения определенной даты из заданной даты.
 +
 +Синтаксис:​
 +КонецПериода(Дата,​ ТипПериода)
 +
 +Параметры:​
 +Дата (Дата). Заданная дата; ​
 +ТипПериода (Строка). Содержит одно из значений:​ Минута;​ Час; День; Неделя;​ Месяц; Квартал;​ Год; Декада;​ Полугодие.
 +
 +Пример:​
 +КонецПериода(ДатаВремя(2002,​ 10, 12, 10, 15, 34), "​Неделя"​)
 +Результат:​ 13.10.2002 23:59:59
 +
 +11. ДобавитьКДате (DateAdd) - функция предназначена для прибавления к дате некоторой величины.
 +
 +Синтаксис:​
 +ДобавитьКДате(Выражение,​ ТипУвеличения,​ Величина)
 +
 +Параметры:​
 +Выражение (Дата). Исходная дата; ​
 +ТипУвеличения (Строка). Содержит одно из значений:​ Минута;​ Час; День; Неделя;​ Месяц; Квартал;​ Год; Декада;​ Полугодие.
 +Величина (Число). На сколько необходимо увеличить дату, дробная часть игнорируется.
 +
 +Пример:​
 +ДобавитьКДате(ДатаВремя(2002,​ 10, 12, 10, 15, 34), "​Месяц",​ 1)
 +Результат:​ 12.11.2002 10:15:34
 +
 +12. РазностьДат (DateDifference) - функция предназначена для получения разницы между двумя датами.
 +
 +Синтаксис:​
 +РазностьДат(Выражение1 , Выражение2 , ТипРазности)
 +
 +Параметры:​
 +Выражение1 (Дата). Вычитаемая дата; ​
 +Выражение2 (Дата). Исходная дата; ​
 +ТипРазности (Строка). Содержит одно из значений:​ Секунда;​ Минута;​ Час; День; Месяц; Квартал;​ Год.
 +
 +Пример:​
 +РАЗНОСТЬДАТ(ДАТАВРЕМЯ(2002,​ 10, 12, 10, 15, 34),
 +   ​ДАТАВРЕМЯ(2002,​ 10, 14, 9, 18, 06), "​ДЕНЬ"​)
 +Результат:​ 2
 +
 +13. Подстрока (Substring) - данная функция предназначена для выделения подстроки из строки.
 +
 +Синтаксис:​
 +Подстрока(Строка,​ Позиция,​ Длина)
 +
 +Параметры:​
 +Строка (Строка). Строка,​ из которой выделяют подстроку; ​
 +Позиция (Число). Позиция символа,​ с которого начинается выделяемая из строки подстрока; ​
 +Длина (Число). Длина выделяемой подстроки.
 +
 +Пример:​
 +ПОДСТРОКА(Контрагенты.Адрес,​ 1, 4)
 +
 +14. ДлинаСтроки (StringLength) - функция предназначена для определения длины строки.
 +
 +Синтаксис:​
 +ДлинаСтроки(Строка)
 +
 +Параметр:​
 +Строка (Строка). Строка,​ длину которой определяют.
 +
 +Пример:​
 +Строка(Контрагенты.Адрес)
 +
 +15. Год (Year) - данная функция предназначена для выделения года из значения типа Дата.
 +
 +Синтаксис:​
 +Год(Дата)
 +
 +Параметр:​
 +Дата (Дата). Дата, по которой определяют год. ​
 +
 +Пример:​
 +ГОД(РасхНакл.Дата)
 +
 +16. Квартал (Quarter) - данная функция предназначена для выделения номера квартала из значения типа Дата. Номер квартала в норме находится в диапазоне от 1 до 4.
 +
 +Синтаксис:​
 +Квартал(Дата)
 +
 +Параметр:​
 +Дата (Дата). Дата, по которой определяют квартал
 +
 +Пример:​
 +КВАРТАЛ(РасхНакл.Дата)
 +
 +17. Месяц (Month) - данная функция предназначена для выделения номера месяца из значения типа Дата. Номер месяца в норме находится в диапа-зоне от 1 до 12.
 +
 +Синтаксис:​
 +Месяц(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют месяц.
 +
 +Пример:​
 +МЕСЯЦ(РасхНакл.Дата)
 +
 +18. ДеньГода (DayOfYear) - данная функция предназначена для получения дня года из значения типа Дата. День года в норме находится в диапазоне от 1 до 365(366).
 +
 +Синтаксис:​
 +ДеньГода(Дата)
 +
 +Параметр:​
 +Дата (Дата). Дата, по которой определяют день года.
 +
 +Пример:​
 +ДЕНЬГОДА(РасхНакл.Дата)
 +
 +19. День (Day) - данная функция предназначена для получения дня месяца из значения типа Дата. День месяца в норме находится в диапазоне от 1 до 31.
 +
 +Синтаксис:​
 +День(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют дня месяца. ​
 +
 +Пример:​
 +ДЕНЬ(РасхНакл.Дата)
 +
 +20. Неделя (Week) - данная функция предназначена для получения номера недели года из значения типа Дата. Недели года нумеруются,​ начиная с 1.
 +
 +Синтаксис:​
 +Неделя(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют номера недели. ​
 +
 +Пример:​
 +НЕДЕЛЯ(РасхНакл.Дата)
 +
 +21. ДеньНедели (WeekDay) - данная функция предназначена для получения дня недели из значения типа Дата. День недели в норме находится в диапазоне от 1 (понедельник) до 7(воскресенье).
 +
 +Синтаксис:​
 +ДеньНедели(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют день недели . 
 +
 +Пример:​
 +ДЕНЬНЕДЕЛИ(РасхНакл.Дата)
 +
 +22. Час (Hour) - данная функция предназначена для получения часа суток из значения типа Дата. Час суток находится в диапазоне от 0 до 23.
 +
 +Синтаксис:​
 +Час(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют час суток. ​
 +
 +Пример:​
 +ЧАС(РасхНакл.Дата)
 +
 +23. Минута (Minute) - данная функция предназначена для получения минуты часа из значения типа Дата. Минута часа находится в диапазоне от 0 до 59.
 +
 +Синтаксис:​
 +Минута(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют минута часа. ​
 +
 +Пример:​
 +МИНУТА(РасхНакл.Дата)
 +
 +24. Секунда (Second) - данная функция предназначена для получения секунды минуты из значения типа Дата. Секунда минуты находится в диапазоне от 0 до 59.
 +
 +Синтаксис:​
 +Секунда(Дата)
 +
 +Параметр:​
 +Дата (Дата). ​ Дата, по которой определяют секунды минуты. ​
 +
 +Пример:​
 +СЕКУНДА(РасхНакл.Дата)
 +
 +25. Выразить (Cast) - данная функция предназначена для выделения типа из выражения,​ которое может содержать составной тип. В случае,​ если выражение будет содержать тип, отличный от требуемого типа, будет возвращено значение NULL.
 +
 +Синтаксис:​
 +Выразить(Выражение,​ УказаниеТипа)
 +
 +Параметры:​
 +Выражение - преобразуемое выражение; ​
 +УказаниеТипа (Строка). Содержит ​ строку типа. Например,​ "​Число",​ "​Строка"​ и т.п. Кроме примитивных типов данная строка может содержать имя таблицы. В этом случае будет осуществлена попытка выразить к ссылке на указанную таблицу.
 +
 +Пример:​
 +Выразить(Данные.Реквизит1,​ "​Число(10,​3)"​)
 +
 +26. ЕстьNull (IsNull) - данная функция возвращает значение второго параметра в случае,​ если значение первого параметра NULL. В противном случае будет возвращено значение первого параметра.
 +
 +Синтаксис:​
 +ЕстьNull(Выражение1,​ Выражение2)
 +
 +Параметры:​
 +Выражение1 - проверяемое значение; ​
 +Выражение2 - возвращаемое значение,​ если значение Выражение1 есть NULL.
 +
 +Пример:​
 +ЕстьNULL(Сумма(Продажи.СуммаОборот),​ 0)
 +
 +27. ACos - вычисляет арккосинус в радианах.
 +
 +Синтаксис:​
 +ACos(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Значение косинуса (в диапазоне -1 ... 1), по которому определяется угол. ​
 +
 +28. ASin - вычисляет арксинус в радианах.
 +
 +Синтаксис:​
 +ASin(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Значение синуса (в диапазоне -1 ... 1), по которому определяется угол. ​
 +
 +29. ATan - вычисляет арктангенс в радианах.
 +
 +Синтаксис:​
 +ATan(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Значение тангенса,​ по которому определяется угол. ​
 +
 +30. Cos - вычисляет косинус.
 +
 +Синтаксис:​
 +Cos(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Задается в радианах. ​
 +
 +31. Exp - возведение числа e в степень.
 +
 +Синтаксис:​
 +Exp(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Значение степени. ​
 +
 +32. Log - вычисляет натуральный логарифм.
 +
 +Синтаксис:​
 +Log(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Исходное число, больше 0. 
 +
 +33. Log10 - вычисляет логарифм X по основанию 10.
 +
 +Синтаксис:​
 +Log10(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Исходное число, больше 0. 
 +
 +34. Pow - возведение в степень.
 +
 +Синтаксис:​
 +Pow(Основание,​ Показатель)
 +
 +Параметры:​
 +Основание (Число). Основание операции возведения в степень. ​
 +Показатель (Число). Показатель степени.
 +
 +35. Sin - вычисляет синус.
 +
 +Синтаксис:​
 +Sin(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Задается в радианах.
 +36. Sqrt - вычисляет квадратный корень.
 +
 +Синтаксис:​
 +Sqrt(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Неотрицательное число. ​
 +
 +37. Tan - вычисляет тангенс.
 +
 +Синтаксис:​
 +Tan(Выражение)
 +
 +Параметр:​
 +Выражение (Число). Значение синуса,​ по которому определяется угол. ​
 +
 +38. Окр (Round) - округляет исходное число до нужной разрядности. Режим округления стандартный (1,5 как 2).
 +
 +Синтаксис:​
 +Окр(Выражение,​ Разрядность)
 +
 +Параметры:​
 +Выражение (Число). ​ Исходное число; ​
 +Разрядность (Число). Число знаков дробной части, до которых производится округление. ​
 +
 +39. Цел (Int) - отсекает дробную часть числа.
 +
 +Синтаксис:​
 +Цел(Выражение)
 +
 +Параметр:​
 +Выражение (Число). ​ Дробное число.
 +
 +40. Функции общих модулей
 +
 +Выражение механизма компоновки данных может содержать вызовы функций глобальных общих модулей конфигурации. Никакого дополнительно синтаксиса для вызова таких функций не требуется.
 +
 +Пример:​
 +СокращенноеНаименование(Документы.Ссылка,​ Документы.Дата,​ Документы.Номер)
 +
 +В данном примере будет осуществлен вызов функции "​СокращенноеНаименование"​ из общего модуля конфигурации.
 +Отметим,​ что использование функций общих модулей разрешено только при указании соответствующего параметра процессора компоновки данных.
 +Кроме того, функции общих модулей не могут быть использованы в выражениях пользовательских полей.
 +
 +41. Представление ​ (Resentation) - данная функция возвращает строковое представление переданного значения не примитивного типа. Для значений примитивного типа возвращает само значение.
 +
 +Если в качестве параметра используется массив или таблица значений,​ то функция возвращает строку,​ содержащую строковые представление всех элементов массива,​ разделенных символами "; ". Если у какого либо элемента строковое представление пустое,​ то вместо его представления выводится строка "<​Пустое значение>"​.
 +
 +Пример:​
 +Представление(Контрагент)
 +
 +42. Строка (String) - данная функция преобразует переданное значение в строку.
 +
 +Если в качестве параметра используется массив или таблица значений,​ то функция возвращает строку,​ содержащую строковые представление всех элементов массива,​ разделенных символами "; ". Если у какого либо элемента строковое представление пустое,​ то вместо его представления выводится строка "<​Пустое значение>"​.
 +
 +Пример:​
 +Строка(ДатаПродажи)
 +
 +43. ЗначениеЗаполнено (ValueIsFilled)
 +
 +Для значений NULL, Неопределено всегда возвращает Ложь.
 +Для значений Булево всегда возвращает Истину.
 +Для остальных типов возвращает Истину,​ если значение отличается от значения по умолчанию для данного типа.
 +
 +Пример:​
 +ЗначениеЗаполнено(ДатаДоставки)
 +
 +44. УровеньВГруппировке (LevelInGroup) - данная функция получает текущий уровень записи относительно группировки.
 +
 +Может быть использована для получения уровня вложенности записи в иерархической группировке.
 +
 +Пример:​
 +УровеньВГруппировке()
 +
 +45. ТипЗначения(ValueType)
 +
 +Синтаксис:​
 +ТипЗначения(Выражение)
 +
 +Параметр:​
 +Выражение (Строка). Строковое значение типа.
 +
 +Возвращает значение типа Тип, содержащее тип значения параметра функции.
 +
 +Copyright © ООО "​1С"​