Функции и расчет итогов
|
<< Click to Display Table of Contents >> Navigation: Создание отчетов > Создание отчетов в MasterSCADA 4D > Источники данных, переменные и функции > Функции и расчет итогов |
В словаре данных представлена отдельная категория Функции. В этой категории представлены элементы, при помощи которых можно рассчитать определенный результат или вернуть необходимое значение. Все элементы категории Функции разделены по группам:

В таблице ниже представлен перечень функций, их описание и краткие примеры.
Функция |
Описание |
Пример |
Data: |
||
{Coalesce()} |
Предоставляет возможность вернуть первое значение, которое не равно null, из списка значений. |
{Coalesce(null, 10, 20)} - в этом случае, результат будет 10, т.к. первое значение равно null. |
{CoalesceStr()} |
Предоставляет возможность вернуть первую непустую строку из списка значений. |
{CoalesceStr("", "Text", "Value")} - в этом случае, результат будет "Текст", т.к. первое значение пустое. |
{GetCrossTabColumnValue()} |
Предоставляет возможность получить значение колонки CrossTab, связанной с текущей ячейкой итогов. |
{GetCrossTabColumnValue(0)} - в этом случае, будет получено значение первого столбца Cross-Tab. |
{GetCrossTabRowValue()} |
Предоставляет возможность получить значение строки CrossTab, связанной с текущей ячейкой итогов. |
{GetCrossTabRowValue(0)} - в этом случае, будет получено значение первой строки Cross-Tab. |
{GetRealPageNumber()} |
Предоставляет возможность получить реальный номер страницы для компонента на сегментированной странице. |
{GetRealPageNumber()} - в этом случае, будет отображен реальный номер текущей страницы отчета. |
{IsAllDataRowNullOrEmpty(,)} |
Предоставляет возможность проверить, содержат ли все значения указанной колонки null или пустую строку. •Источник данных (тип object); •Имя колонки данных (тип string). Возвращает значение типа bool. |
{IsAllDataRowNullOrEmpty(DataSource.Column1, DataSource.Column2)} - в этом случае, результат будет true, если значения Column1 и Column2 пустые или равны null. |
{IsDataEmpty()} |
Предоставляет возможность определить, содержит ли источник данных строки. |
{IsDataEmpty()} - в этом случае, результат будет true, если источник данных не содержит записей. |
{IsNull(,)} |
Предоставляет возможность выявить значения null в указанной колонке данных. Если будет присутствовать значение null, то результат будет true, иначе - false. •Источник данных (тип object); •Имя колонки данных (тип string). Возвращает значение типа bool. |
{IsNull(DataSource.Column)} - в этом случае, в построенном отчете, вместо значений null будет отображаться значение true, а вместо других значений - false. |
{IsNullOrEmpty(,)} |
Предоставляет возможность проверить, является ли значение строки null или пустой строкой. •Источник данных (тип object); •Имя колонки данных (тип string). Возвращает значение типа bool. |
{IsNullOrEmpty("")} - в этом случае, результат будет true, т.к. строка пустая. |
{IsNullOrWhiteSpace(,)} |
Предоставляет возможность проверить, является ли значение null, пустой строкой или содержит только пробелы. •Источник данных (тип object); •Имя колонки данных (тип string). Возвращает значение типа bool. |
{IsNullOrWhiteSpace(" ")} - в этом случае, результат будет true, т.к. строка содержит только пробелы. |
{IsNumeric()} |
Предоставляет возможность определить, является ли значение числом. |
{IsNumeric("123")} - в этом случае, результат будет true, т.к. значение является числом. |
{JoinColumnContent(,,)} |
Предоставляет возможность объединить все значения колонки источника данных в одну строку через разделитель. •Источник данных (тип object); •Имя колонки данных (тип string); •Разделитель (тип string). Возвращает строковое значение. |
{JoinColumnContent(DataSource, "Column1", ", ")} - в этом случае, значения столбца Column1 будут объединены через ", ". |
{Next(,)} |
Предоставляет возможность отобразить значение из следующей строки. Если значения следующей строки null, то результатом будет 0. |
Например, колонка данных Column содержит значения 2, 5, 9. Тогда используя функцию {Next(DataSource,"Column")}, в результате первое значение будет 5, второе 9, третье - null. |
{NextIsNull(,)} |
Предоставляет возможность сравнить значение строки со значением следующей строки. Если значение следующей строки будет 0 или null, то результат будет true, иначе - false. •Источник данных (тип object); •Имя колонки данных (тип string). Возвращает значение типа bool. |
Например, колонка данных Column содержит значения 2, 0, 9. Тогда используя функцию {NextIsNull(DataSource,"Column")}, в результате первое значение будет true, второе - false, третье - true. |
{Previous(,)} |
Предоставляет возможность отобразить значение из предыдущей строки. Если значения следующей строки null, то результатом будет 0. |
Например, колонка данных Column содержит значения 2, 5, 9. Тогда используя функцию {Previous(DataSource,"Column")}, в результате первое значение будет null, второе 2, третье - 5. |
{PreviousIsNull(,)} |
Предоставляет возможность сравнить значение строки со значением предыдущей строки. Если значение предыдущей строки будет 0 или null, то результат будет true, иначе - false. •Источник данных (тип object); •Имя колонки данных (тип string). Возвращает значение типа bool. |
Например, колонка данных Column содержит значения 2, 9, 0. Тогда используя функцию {PreviousIsNull(DataSource,"Column")}, в результате первое значение будет true, второе - false, третье - false. |
{ToQueryString(,,)} |
Предоставляет возможность преобразовать список значений в строку запроса. •Список значений; •Символ кавычек; •Формат даты. Возвращает строковое значение. |
{ToQueryString("id", 15, "name", "John")} - в этом случае, результат будет "id=15&name=John". |
{VLookup(,,,)} |
Предоставляет возможность найти значение в одной колонке и вернуть связанное значение из другой колонки той же строки. •Значение для поиска; •Источник данных (тип object); •Колонка поиска (тип string); •Колонка возвращаемого значения (тип string). Возвращает найденное значение. |
{VLookup(DataSource, 1001, "Id", "Name")} - в этом случае, будет найдено значение в столбце Name для строки, где Id = 1001. |
{VLookupStr(,,,,)} |
Предоставляет возможность выполнить поиск строкового значения в колонке и вернуть связанное значение из другой колонки. •Значение для поиска; •Источник данных (тип object); •Колонка поиска (тип string); •Колонка возвращаемого значения (тип string); •Признак точного совпадения (тип bool). Возвращает найденное значение. |
{VLookupStr(DataSource, 1001, "Id", "Name", "Unknown")} - в этом случае, будет найдено значение в столбце Name для строки, где Id = 1001. Если значение не найдено, будет возвращено "Unknown". |
Date Time: |
||
{AddDays(,)} |
Добавляет указанное количество дней к заданной дате. •Дата (тип DateTime); •Количество добавляемых дней (double, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddDays(DateSerial(2022,1,1), 10)} - результат, в этом случае, будет 11.01.2022 00:00:00, т.е. будет прибавлено 10 дней. |
{AddHours(,)} |
Добавляет указанное количество часов к заданной дате. •Дата (тип DateTime); •Количество добавляемых часов (double, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddHours(DateSerial(2022,1,1), 5)} - результат, в этом случае, будет 01.01.2022 05:00:00, т.е. будет прибавлено 5 часов. |
{AddMilliseconds(,)} |
Добавляет указанное количество миллисекунд к заданной дате. •Дата (тип DateTime); •Количество добавляемых миллисекунд (double, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddMilliseconds(DateSerial(2022,1,1), 500)} - результат, в этом случае, будет 01.01.2022 12:00:00, т.е. будет прибавлено 500 миллисекунд. |
{AddMinutes(,)} |
Добавляет указанное количество минут к заданной дате. В аргументах указывается: •Дата (тип DateTime); •Количество добавляемых минут (double, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddMinutes(DateSerial(2022,1,1), 30)} - результат, в этом случае, будет 01.01.2022 00:30:00, т.е. будет прибавлено 30 минут. |
{AddMonths(,)} |
Добавляет указанное количество месяцев к заданной дате. •Дата (тип DateTime); •Количество добавляемых месяцев (int, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddMonths(DateSerial(2022,1,1), 2)} - результат, в этом случае, будет 01.03.2022 00:00:00, т.е. к дате будет прибавлено 2 месяца. |
{AddSeconds(,)} |
Добавляет указанное количество секунд к заданной дате. •Дата (тип DateTime); •Количество добавляемых секунд (double, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddSeconds(DateSerial(2022,1,1), 30)} - результат, в этом случае, будет 01.01.2022 00:00:45, т.е. к значению времени будет прибавлено 30 секунд. |
{AddYears(,)} |
Добавляет указанное количество лет к заданной дате. •Дата (тип DateTime); •Количество добавляемых лет (int, может быть положительным или отрицательным). Возвращает значение DateTime. |
{AddYears(DateSerial(2022,1,1), 1)} - результат, в этом случае, будет 01.01.2023 00:00:00, т.е. будет добавлен 1 год. |
{DateDiff(,)} |
Вычисляет интервал между указанными датами. |
{DateDiff(DateSerial(2022,1,30),DateSerial(2022,1,1))} - результат, в этом случае, будет 29.00:00:00, т.е. 29 дней. |
{DateSerial(,,)} |
Предоставляет возможность указать дату. |
{DateSerial(2022,1,30)} - в этом случае, результат будет 1/30/2022 12:00:00 АМ |
{Day()} |
Предоставляет возможность отобразить день из указанной даты. |
{Day(DateSerial(2022,1,30))} - в этом случае, результат будет 30, т.к. в аргументах указано тридцатое января 2022 года. |
{DayOfWeek()} |
Предоставляет возможность отобразить день недели из указанной даты в текстовом виде. •Дата (тип DateTime); •Культура (тип string); •Значение true or false (тип bool), для отображения результата с заглавной буквы или со строчной; •Значение true or false (тип bool), в зависимости от которого будет использоваться системная культура или локализация дизайнера. Возвращает значение string. |
{DayOfWeek(DateSerial(2022,1,30))} - в этом случае, результат будет sunday. |
{DayOfYear()} |
Предоставляет возможность отобразить день года. |
{DayOfYear(DateSerial(2022,2,14))} - в этом случае, результат будет 45, т.к. 14 февраля это 45-ый день года. |
{DaysInMonth()} |
Предоставляет возможность отобразить количество дней в месяце. •Дата (тип DateTime); •Год и месяц (тип long). Возвращает значение long. |
{DaysInMonth(DateSerial(2024,2,1))} - в этом случае, результат будет 29, т.к. 2024 год является високосным и в феврале 29 дней. |
{DaysInYear()} |
Предоставляет возможность отобразить количество дней в году. |
{DaysInYear(2024)} - в этом случае, результат будет 366 дней, поскольку 2024 год является високосным годом. |
{FromOADate()} |
Преобразует значение OLE Automation Date в DateTime. |
{FromOADate(45200)} -результат, в этом случае, будет 10.1.2023 12:00:00, т.е. числовое значение будет преобразовано в дату. |
{Hour()} |
Предоставляет возможность отобразить час из времени. |
{Hour(DataSource.Column)} - в этом случае, из каждого значения будет отображен час. Например, если время 16:22:36, то результатом будет 16. |
{LocalTimeToUtc()} |
Предоставляет возможность преобразовать локальное время в формат UTC. |
{LocalTimeToUtc(ParseDateTime("2025-05-20 15:00:00"))} - в этом случае, локальное время будет преобразовано в UTC. |
{Minute()} |
Предоставляет возможность отобразить минуты из времени. |
{Minute(DataSource.Column)} - в этом случае, из каждого значения будут отображены минуты. Например, если время 16:22:36, то результатом будет 22. |
{Month()} |
Предоставляет возможность отобразить месяц из даты. |
{Month(DateSerial(2022,12,1))} - в этом случае, результатом будет 12, поскольку установлена дата первое декабря 2016. |
{MonthIdent()} |
Позволяет получить название или идентификатор месяца на основе даты. |
{MonthIdent(DataSource.DocumentDate)} - будет возвращен месяц, соответствующий дате документа. |
{MonthName()} |
Предоставляет возможность отобразить название месяца из указанной даты. •Дата (тип DateTime) и культура (тип string); •Культура (тип string); •Значение true or false (тип bool), для отображения результата с заглавной буквы или со строчной; •Значение true or false (тип bool), в зависимости от которого будет использоваться системная культура или локализация дизайнера. Возвращает значение string. |
{MonthName(DateSerial(2022,1,1))} - в этом случае, результатом будет January, поскольку установлена дата первое января 2022 года. |
{Second()} |
Предоставляет возможность отобразить секунды из времени. |
{Second(DataSource.Column)} - в этом случае, из каждого значения будут отображены секунды. Например, если время 16:22:36, то результатом будет 36. |
{TimeSerial(,,)} |
Предоставляет возможность отобразить время. |
{TimeSerial(1,14,20)} - в этом случае, результат будет 01:14: 20, т.е. один час, 14 минут, 20 секунд. |
{ToJapaneseDateString()} |
Возвращает дату, преобразованную в строку в японском календаре. |
{ToJapaneseDateString(DataSource.Date)} - вернет дату в японском формате. |
{ToOADate()} |
Преобразует DateTime в формат OLE Automation Date. |
{ToOADate(DataSource.Date)} - вернет число, соответствующее дате. |
{UtcToLocalTime()} |
Предоставляет возможность преобразовать время UTC в локальное системное время. |
{UtcToLocalTime(ParseDateTime("2025-05-20 12:00:00"))} - в этом случае, UTC-время будет преобразовано в локальное время. |
{WeekOfMonth()} |
Возвращает номер недели месяца для указанной даты. •Дата (тип DateTime); •значение перечисления. Возвращает значение long. |
{WeekOfMonth(DataSource.SaleDate)} - будет возвращен номер недели в месяце. |
{WeekOfYear()} |
Возвращает номер недели года для указанной даты. •Дата (тип DateTime); •значение перечисления. Возвращает значение long. |
{WeekOfYear(DataSource.SaleDate)} - будет возвращен номер недели в году. |
{Year()} |
Предоставляет возможность отобразить год. |
{Year(DateSerial(2022,1,2))} - в этом случае, результатом будет 2022, поскольку указана дата второе января 2022 года. |
Drawing: |
||
{ARGB(,,,)} |
Предоставляет возможность создать цвет на основе компонентов ARGB (прозрачность, красный, зеленый, синий). •Значение прозрачности Alpha от 0 до 255; •Значение красного цвета Red от 0 до 255; •Значение зеленого цвета Green от 0 до 255; •Значение синего цвета Blue от 0 до 255. Возвращает значение типа Color. |
{ARGB(255, 255, 0, 0)} - в этом случае, будет создан непрозрачный красный цвет. |
{ColorFade(,)} |
Предоставляет возможность сделать цвет темнее или светлее на указанное значение. •Цвет; •Значение изменения яркости от -1 до 1. Возвращает значение типа Color. |
{ColorFade("Red", "Blue")} - в этом случае, будет создан переход от красного цвета к синему. |
{ColorValue()} |
Предоставляет возможность преобразовать строковое представление цвета в объект Color. |
{ColorValue("Red")} - в этом случае, будет получен красный цвет. |
{FontValue(,)} |
Предоставляет возможность создать шрифт с указанным именем, размером и стилем. •Название шрифта; •Размер шрифта; •Стиль шрифта. Возвращает значение типа Font. |
{FontValue("Arial", 12)} - в этом случае, будет создан шрифт Arial размером 12. |
{GlareBrushValue(,,,,)} |
Предоставляет возможность создать кисть с эффектом блика. •Начальный цвет градиента; •Конечный цвет градиента; •Угол наклона градиента; •Центр градиента; •Скорость перехода цветов. Возвращает значение типа GlareBrush. |
{GlareBrushValue("Red", 45, 0.5, 1, "Horizontal")} - в этом случае, будет создана кисть с эффектом блика красного цвета. |
{GlassBrushValue(,,)} |
Предоставляет возможность создать кисть со стеклянным эффектом. •Цвет кисти; •Признак отображения штриховки; •Коэффициент смешивания. Возвращает значение типа GlassBrush. |
{GlassBrushValue("White", 0.7, 0.5)} - в этом случае, будет создана кисть со стеклянным эффектом белого цвета. |
{GradientBrushValue(,,)} |
Предоставляет возможность создать градиентную кисть. •Начальный цвет градиента; •Конечный цвет градиента; •Угол наклона градиента. Возвращает значение типа GradientBrush. |
{GradientBrushValue("Red", "Yellow", 45)} - в этом случае, будет создана градиентная кисть от красного к желтому под углом 45 градусов. |
{HatchBrushValue(,,)} |
Предоставляет возможность создать штриховую кисть. •Стиль штриховки; •Цвет штриховки; •Цвет фона. Возвращает значение типа HatchBrush. |
{HatchBrushValue("DiagonalCross", "Black", "White")} - в этом случае, будет создана штриховая кисть с диагональным пересечением. |
{RGB(,,)} |
Предоставляет возможность создать цвет на основе RGB-компонентов. •Значение красного цвета Red от 0 до 255; •Значение зеленого цвета Green от 0 до 255; •Значение синего цвета Blue от 0 до 255. Возвращает значение типа Color. |
{RGB(255, 0, 0)} - в этом случае, будет создан красный цвет. |
{SolidBrushValue()} |
Предоставляет возможность создать сплошную кисть указанного цвета. |
{SolidBrushValue("Red")} - в этом случае, будет создана сплошная кисть красного цвета. |
Math: |
||
{Abs()} |
Предоставляет возможность возвратить абсолютно число. |
{Abs(-42)} - в этом случае, результат будет 42 |
{Acos()} |
Предоставляет возможность отобразить угол в радианах. |
{Acos(-1)} - в этом случае, будет вычислен угол в радианах для значения cos = -1, т.е. угол будет равен ~ 3.14. |
{Asin()} |
Предоставляет возможность отобразить угол в радианах. |
{Asin(0)} - в этом случае, будет вычислен угол в радианах для значения sin = 0, т.е. угол будет равен 0. |
{Atan()} |
Предоставляет возможность отобразить угол в радианах. |
{Atan(-1)} - в этом случае, будет вычислен угол в радианах для значения tan = -1, т.е. угол будет равен ~ -0.79 |
{Ceiling()} |
Предоставляет возможность отобразить максимальное целочисленное значение к указанному числу. |
{Ceiling(25.124)} - в этом случае, результат будет 26. Стоит отметить, что при применении данной функции не происходит округление числа. |
{Clamp(,,)} |
Предоставляет возможность ограничить значение указанным диапазоном. •Проверяемое значение; •Минимальное значение диапазона; •Максимальное значение диапазона. Возвращает значение в пределах указанного диапазона. |
{Clamp(15, 0, 10)} - в этом случае, результат будет 10, т.к. значение превышает максимальную границу. |
{Cos()} |
Предоставляет возможность вычислить и отобразить значение cos. |
{Cos(0)} - в этом случае, результат будет 1. |
{Div()} |
Предоставляет возможность отобразить результат деления одного аргумента на другой. •Делимое и делитель (тип double, decimal, long); •Делимое, делитель и значение, которое будет результатом, если делитель равен 0. Возвращает значение типа double, decimal, long. |
{Div(2,1)} - в этом случае, результат будет 2, т.к. 2 / 1 = 2 |
{Exp()} |
Предоставляет возможность отобразить результат возведения в указанную степень числа e. |
{Exp(4)} - в этом случае, число е будет возведено в 4-ую степень. |
{Floor()} |
Предоставляет возможность отобразить минимальное целочисленное значение к указанному числу. |
{Floor(123.59)} - в этом случае, результат будет 123, т.к. это ближайшее минимальное целое число. Стоит отметить, что данная функция не производит округление. |
{Frac()} |
Предоставляет возможность получить дробную часть числа. |
{Frac(10.75)} - в этом случае, результат будет 0.75. {Frac(3.1415)} - в этом случае, результат будет 0.1415. |
{Log()} |
Предоставляет возможность вычислить натуральный логарифм. |
{Log(x)}, где х - это число или выражение, результатом будет вычисление натурального логарифма. |
{Maximum(,)} |
Предоставляет возможность сравнить два значения и отобразить максимальное. |
{Maximum(5,9)} - в этом случае, результатом будет число 9. |
{Minimum(,)} |
Предоставляет возможность сравнить два значения и отобразить минимальное. |
{Minimum(5,9)} - в этом случае, результатом будет число 5. |
{Round()} |
Предоставляет возможность округлить значение до целого числа или до определенного количества знаков дробной части. •Значение (тип decimal, double); •Число знаков, до которого следует округлить дробную часть (тип int). Возвращает значение типа decimal, double. |
{Round(7.56)} - в этом случае, результат будет 8 |
{Sign()} |
Предоставляет возможность отобразить индикатор со знаком числа. Для положительных чисел 1, 0 - для всех нулевых значений, -1 - для отрицательных значений. |
{Sign(256)} - в этом случае, результат будет 1. |
{Sin(0)} |
Предоставляет возможность вычислить sin угла. |
{Sin(0)} - в этом случае, результат будет 0. |
{Sqrt()} |
Предоставляет возможность вычислить квадратный корень из числа. |
{Sqrt(4)} - в этом случае, результат будет 2, т.к. квадратный корень из 4 равен 2. |
{Tan()} |
Предоставляет возможность вычислить tg угла. |
{Tan(90)} - в этом случае, результат будет ~ -1.995 |
{Truncate()} |
Предоставляет возможность отобразить только целую часть без округления. |
{Truncate(Sqrt(5))} - в этом случае, результат будет число 2, т.к. квадратный корень из 5 равен ~ 2.236, т.е. целая часть в этом числе и есть 2. |
Programming: |
||
{Choose()} |
Предоставляет возможность отобразить значение по индексу. |
Все группы товаров сгруппированы по категориям: дорогие товары, товары средней цены, дешевые товары. Каждой группе присвоен индекс: дорогие - индекс 1, средние - индекс 2, дешевые - индекс 3. В отчете следует отобразить вместо их индекса - категорию. В этом случае, можно воспользоваться функцией Choose. |
{Eval()} |
Позволяет вычислить выражение, переданное в виде строки. |
В отчете необходимо динамически вычислить значение на основе строки, например формулы, полученной из данных. В этом случае можно воспользоваться функцией Eval. |
{IIF(,,)} |
Предоставляет возможность использовать отобразить то или иное значение, в зависимости от условия. |
В отчете со складскими запасами необходимо отслеживать количество товаров. Задача логиста состоит в том, что когда количество товаров приближается к нулю (меньше 6), необходимо произвести заказ этих товаров. Для того чтобы выделять критические позиции в отчете визуально можно воспользоваться функцией {IIF(,,)} |
{Rand()} |
Возвращает случайное число. |
В отчете требуется сгенерировать случайное значение, например для тестовых данных или случайной выборки. В этом случае можно воспользоваться функцией Rand. {Rand()} - вернет случайное число, например 0.7345. |
{Runtime()} |
Возвращает текущее время выполнения отчета. |
В отчете необходимо отобразить время генерации отчета. В этом случае можно воспользоваться функцией Runtime. {Runtime()} - отобразит текущую дату и время выполнения отчета. |
{Switch()} |
Предоставляет возможность присвоить заданное значение при выполнении определенного условия. |
Например, в отчете отображается список сотрудников, и необходимо отобразить их должность: Nancy - ведущий менеджер проекта, Andrew - главный разработчик, остальные сотрудники (их 6 человек) - Junior. В этом случае, функция Switch будет иметь три пары аргументов "условие-значение": |
Strings: |
||
{Arabic()} |
Предоставляет возможность конвертировать указанные цифры в цифры на арабском. |
{Arabic(2)} - в этом случае, цифра 2 будет иметь арабское написание. |
{Compare(,)} |
Предоставляет возможность сравнить две строки и определить их положение в порядке сортировки. •Первая строка; •Вторая строка. Возвращает значение типа int: •меньше 0, если первая строка меньше второй; •0, если строки равны; •больше 0, если первая строка больше второй. |
{Compare(10, 20)} - в этом случае, результат будет -1, т.к. 10 меньше 20. |
{ConvertToBase64String()} |
Предоставляет возможность преобразовать строку в формат Base64. |
{ConvertToBase64String("Hello")} - в этом случае, результат будет "SGVsbG8=". |
{DateToStr()} |
Предоставляет возможность сконвертировать дату в текстовое значение. •Дата (тип DateTime); •Булевские значения (true or false) для вывода отображения заголовка с заглавной буквы или со строчной. Возвращает значение типа string. |
{DateToStr(DataSource.Column1)} - в этом случае, все даты из Column1 будут отображаться в текстовом виде. |
{Insert(,,)} |
Предоставляет возможность вставить значение после определенногое символа в другое значение. •значение , в которое будет производиться вставка текста (тип string); •номер символа, после которого будет вставлено значение (тип int); •значение для вставки (тип string). Возвращает значение типа string. |
{Insert("25",2," dollars")} - в этом случае, в значение 25, после второго символа будет вставлено значение dollars, т.е. результат будет 25 dollars. |
{Left()} |
Предоставляет возможность отобразить указанное количество символов от левой стороны значения. |
{Left("Beverages", 4)} - в этом случае, будет отображено только четыре символа из значения Beverages, т.е. результат будет Beve. |
{Length()} |
Предоставляет возможность отобразить количество символов для указанного значения. |
{Length("Beverages")} - в этом случае, результат будет число 9, т.к. значение Beverages состоит из девяти символов. |
{Mid()} |
Предоставляет возможность отобразить символы из значения. При этом можно задать позицию отсчета. •Значение (тип string); •Индекс позиции отсчета (тип int); •Количество символов, которое необходимо отобразить (тип int). Возвращает значение типа int. |
{Mid("Beverages",2,3)} - в этом случае, будет отображено три символа, после первых двух, т.е. результат будет ver. |
{ParseDateTime()} |
Предоставляет возможность преобразовать строковое представление значения в соответствующий числовой или дата-тип. •ParseDateTime() - значение типа DateTime; •ParseDecimal() - значение типа Decimal; •ParseDouble() - значение типа Double; •ParseLong() - значение типа Long. |
{ParseDateTime("2025-05-20")} - в этом случае, строковое значение будет преобразовано в дату 20 May 2025. |
{Persian()} |
Предоставляет возможность конвертировать указанные цифры в цифры на персидском. |
{Persian(5)} - в этом случае, цифра 2 будет иметь персидское написание. |
{Remove()} |
Предоставляет возможность удалить указанное количество символов с индекса определенной позиции. •Значение (тип string); •Индекс позиции отсчета (тип int); •Количество символов, которое необходимо удалить (тип int). Возвращает значение типа int. |
{Remove("Beverages",2,3)} - в этом случае, после второго символа будет удалено три символа, т.е. результат будет Beages. |
{Replace(,,)} |
Предоставляет возможность заменить определенные символы или их сочетание на другие символы. •Значение (тип string), в котором будет производиться замена; •Символы, которые необходимо заменить (тип string); •Символы, которые необходимо вставить (тип string). Возвращает значение типа string. |
{Replace("Beverages","ver","NEW")} - в этом случае, в значении Beverages, символы ver будут заменены на символы NEW, т.е. результат будет BeNEWages. |
{Right()} |
Предоставляет возможность отобразить указанное количество символов от правой стороны значения. |
{Right("Beverages",3)} - в этом случае, будет отображено три символа от правой стороны значения. т.е. ges. |
{Roman()} |
Предоставляет возможность сконвертировать арабские цифры в римские. |
{Roman(4)} - в этом случае, цифра 4 будет иметь римское написание. |
{Substring()} |
Предоставляет возможность отобразить определенное число символов с указанной позиции. •Значение (тип string), из которого будут отображаться символы; •Индекс позиции (тип int), т.е. сколько символов пропускается; •Количество символов, которые необходимо отобразить (тип int). Возвращает значение типа string. |
{Substring("Beverages",6,3)} - в этом случае, первые шесть символов пропускаются и будет отображаться три символа, т.е. результат будет ges. |
{ToCurrencyWords()} |
Предоставляет возможность отобразить валютную стоимость текстом. •Аргумет числовое значение (double, decimal, long), которое будет конвертировано в текст; •Аргумент (true or false) определяет отображение текста с заглавной или строчной буквы; •Аргумент (true or false) определяет отображения центов; •Аргумент, который предоставляет возможность определить формат единственного и множественного числа для валюты и центов (тип string); •Аргумент, который предоставляет возможность определить базовую единицу измерения для целой и дробной части. Кроме этого, возможно различные комбинации аргументов. Также есть виды этой функции, поддерживающие различные культуры. Обратите внимание, также есть возможность указать ISO код (тип string) валюты. |
{ToCurrencyWords(100)} - по умолчанию, используется валюта dollars of USA, поэтому результат вычисления функции будет: "One hundred dollars and zero cents". |
{ToLowerCase()} |
Предоставляет возможность отобразить значение в нижнем регистре. |
{ToLowerCase("EURO")} - в этом случае, результат будет euro. |
{ToOrdinal()} |
Предоставляет возможность преобразовать число в порядковое числительное. |
{ToOrdinal(25)} - - в этом случае, результат будет 25th. |
{ToProperCase()} |
Предоставляет возможность преобразовать текст в формат первый символ заглавный, остальные в нижнем регистре. |
{ToProperCase("dOllars")} - - в этом случае, результат будет Dollars. |
{ToString()} |
Предоставляет возможность преобразовать значение в строковое представление. |
{ToString(12345)} - в этом случае, результат будет "12345". |
{ToUpperCase()} |
Предоставляет возможность отобразить значение в верхнем регистре. |
{ToUpperCase("dollars")} - в этом случае, результат будет DOLLARS. |
{ToWords()} |
Предоставляет возможность отобразить число текстом. •Числовое значение, которое будет преобразовано в текст (decimal, double, long); •Значение true or false для отображения с заглавное буквы для первого символа или нет; •Значение true or false для возврата нулевых и пустых значений; •Также возможен вариант указать true or false для предания женской формы для результата. Возвращает значение типа string. |
{ToWords(100)} - в этом случае, результат будет one hundred. |
{Trim()} |
Предоставляет возможность обрезать пробелы в начале или конце строки. |
{Trim(" <1 dollars> ")} - в этом случае результат в этом случае будет "<1 dollars>". |
{TryParseDecimal()} |
Предоставляют возможность проверить значение для конвертации в тип decimal, double,long. |
{TryParseLong("100")} - в этом случае результат будет true, т.е. значение можно будет сконвертировать в long. |