Конвертирования: различия между версиями

Версия от 08:53, 20 февраля 2026

Функции преобразования - позволяют явно преобразовать значение из одного типа данных в другой.

Необходимы для обеспечения строгой типизации при выполнении расчетов, фильтрации или отображении данных в отчетах.

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

Функция	Описание	Применение
ToBoolean	Преобразование параметра к логическому типу	`ToBoolean(<Value>)` `=ToBoolean(Fields!HouseOwnerFlag.Value)`
ToByte	Преобразование параметра к числовому типу	`ToByte(<Value>)` `=ToByte(Fields!ProductNumber.Value)`
ToDateTime	Преобразование параметра к типу дата-время	`ToDateTime(<Value>)` `=ToDateTime(Fields!SaleDate.Value); =ToDateTime("1 January, 2017")`
ToDouble	Преобразование параметра к числу с ПЗ (двойная точность)	`ToDouble(<Value>)` `=ToDouble(Fields!AnnualSales.Value); =ToDouble(535.85 * .2691 * 67483)`
ToInt16	Преобразование параметра к 16-битному числу (-32767..32768)	`ToInt16(<Value>)` `=ToInt16(Fields!AnnualSales.Value); =ToInt16(535.85)`
ToInt32	Преобразование параметра к 32-битному числу	`ToInt32(<Value>)` `=ToInt32(Fields!AnnualSales.Value)`
ToInt64	Преобразование параметра к 64-битному числу	`ToInt64(<Value>)` `=ToInt64(Fields!AnnualSales.Value)`
ToSingle	Преобразование параметра к числу с ПЗ (одинарная точность)	`ToSingle(<Value>)` `=ToSingle(Fields!AnnualSales.Value);` `=ToSingle(15.857692134)`
ToUInt16	Преобразование параметра к 16-битному беззнаковому числу (0..65534)	`ToUInt16(<Value>)` `=ToUInt16(Fields!AnnualSales.Value)`
ToUInt32	Преобразование параметра к 32-битному беззнаковому числу	`ToUInt32(<Value>)` `=ToUInt32(Fields!AnnualSales.Value)`
ToUInt64	Преобразование параметра к 32-битному беззнаковому числу	`ToUInt64(<Value>)` `=ToUInt64(Fields!AnnualSales.Value)`

@@ Строка 12: / Строка 12: @@
 |-
 |ToBoolean
-|Преобразует числа в тип Boolean (логический)
+|Преобразование параметра к логическому типу
-|<code>=ToBoolean(<ИмяПоля>)</code>
+|<code>ToBoolean(<Value>)</code>
+<code>=ToBoolean(Fields!HouseOwnerFlag.Value)</code>
+|-
+|ToByte
+|Преобразование параметра к числовому типу
+|<code>ToByte(<Value>)</code>
+<code>=ToByte(Fields!ProductNumber.Value)</code>
 |-
 |ToDateTime
-|Пытается распознать входное значение как допустимую дату или время, используя текущие региональные настройки отчета
+|Преобразование параметра к типу дата-время
-|<code>=ToDateTime(<ДатаВремя>)</code>
+|<code>ToDateTime(<Value>)</code>
+<code>=ToDateTime(Fields!SaleDate.Value); =ToDateTime("1 January, 2017")</code>
 |-
-|ToDecimal
+|ToDouble
-|Преобразует в число с дробной частью (фиксированная запятая, высокая точность, немного медленнее)
+|Преобразование параметра к числу с ПЗ (двойная точность)
-|<code>=ToDecimal(<ИмяПоля>)</code>
+|<code>ToDouble(<Value>)</code>
+<code>=ToDouble(Fields!AnnualSales.Value); =ToDouble(535.85 * .2691 * 67483)</code>
 |-
-|ToDouble
+|ToInt16
-|Преобразует в число с дробной частью (плавающая запятая, меньшая точность, обычно быстрее)
+|Преобразование параметра к 16-битному числу (-32767..32768)
-|<code>=ToDouble(<ИмяПоля>)</code>
+|<code>ToInt16(<Value>)</code>
+<code>=ToInt16(Fields!AnnualSales.Value); =ToInt16(535.85)</code>
 |-
 |ToInt32
-|Преобразует в целое число (от -2 млрд. до 2 млрд.)
+|Преобразование параметра к 32-битному числу
-|<code>=ToInt32(<ИмяПоля>)</code>
+|<code>ToInt32(<Value>)</code>
+<code>=ToInt32(Fields!AnnualSales.Value)</code>
+|-
+|ToInt64
+|Преобразование параметра к 64-битному числу
+|<code>ToInt64(<Value>)</code>
+<code>=ToInt64(Fields!AnnualSales.Value)</code>
+|-
+|ToSingle
+|Преобразование параметра к числу с ПЗ (одинарная точность)
+|<code>ToSingle(<Value>)</code>
+<code>=ToSingle(Fields!AnnualSales.Value);</code>
+<code>=ToSingle(15.857692134)</code>
+|-
+|ToUInt16
+|Преобразование параметра к 16-битному беззнаковому числу (0..65534)
+|<code>ToUInt16(<Value>)</code>
+<code>=ToUInt16(Fields!AnnualSales.Value)</code>
+|-
+|ToUInt32
+|Преобразование параметра к 32-битному беззнаковому числу
+|<code>ToUInt32(<Value>)</code>
+<code>=ToUInt32(Fields!AnnualSales.Value)</code>
 |-
-|ToString
+|ToUInt64
-|Преобразует в строку
+|Преобразование параметра к 32-битному беззнаковому числу
-|<code>=ToString(<ИмяПоля>)</code>
+|<code>ToUInt64(<Value>)</code>
+<code>=ToUInt64(Fields!AnnualSales.Value)</code>
 |-
 |}