Функция Str

Возвращает значение типа Variant (String), представляющее собой число.

Синтаксис Str(число)

Обязательный аргумент число — это значение типа Long, представляющее собой любое допустимое числовое выражение.

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

Функция Format служит для преобразования числового значения в формат даты, времени, денежный или любой другой формат, определяемый пользователем. Однако, в отличии от Str, функция Format не включает первый пробел в качестве знака числа.

Примечание. В качестве допустимого десятичного разделителя для функции Str выступает точка (.). Для преобразования числа в строку при использовании других десятичных разделителей (например, в международных приложениях) пользуйтесь функцией CStr.

Функции преобразования типа

Каждая функция относит выражение к определенному типу данных.

Синтаксис

CBool(выражение)

CByte(выражение)

CCur(выражение)

CDate(выражение)

CDbl(выражение)

CDec(выражение)

CInt(выражение)

CLng(выражение)

CSng(выражение)

CStr(выражение)

CVar(выражение)

Обязательный аргумент выражение является любым строковым или числовым выражением.

Возвращаемые типы

Имя функции определяет возвращаемый тип, как показано в следующей таблице.

Функция	Возвращаемый тип	Диапазон аргумента выражение
CBool	Boolean	Любое допустимое строковое или числовое выражение.
CByte	Byte	От 0 до 255.
CCur	Currency	От -922337203685477,5808 до 922337203685477,5807.
CDate	Date	Любое допустимое выражение даты.
CDbl	Double	От -1,79769313486231E308 до -4,94065645841247E-324 для отрицательных чисел; от 4,94065645841247E-324 до 1,79769313486232E308 для положительных чисел.
CDec	Decimal	+/-79228162514264337593543950335 для чисел с нулевым масштабным фактором, т. е. без десятичных разрядов. Для чисел с 28 десятичными разрядами значения принадлежат диапазону +/-7,9228162514264337593543950335. Минимальное ненулевое число равно 0,0000000000000000000000000001.
CInt	Integer	от -32 768 до 32 767; дробные части округляются.
CLng	Long	от -2147483648 до 2147483647; дробные части округляются.
CSng	Single	От -3,402823E38 до -1,401298E-45 для отрицательных чисел; от 1,401298E-45 до 3,402823E38 для положительных чисел.
CStr	String	Returns for CStr depend on the expression argument.
CVar	Variant	Такой же диапазон, как у функции Double для чисел. Такой же диапазон, как у функции String для других символов.

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

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

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

Если дробная часть числа составляет 0,5, функции CInt и CLng всегда округляют ее до ближайшего четного числа. Например, 0,5 округляется до 0, а 1,5 округляется до 2. Функции CInt и CLng отличаются от функций Fix и Int, которые скорее обрезают, чем округляют дробную часть числа. К тому же функции Fix и Int всегда возвращают значение того же типа, который был задан при передаче данных.

Функция IsDate используется для определения возможности преобразования даты в дату или время. Функция CDate распознает литералы даты и времени, а также числа, находящиеся в диапазоне допустимых значений. При преобразовании числа в дату целая часть числа становится датой. Любая дробная часть числа преобразуется во время дня начиная с полуночи.

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

Функция CVDate также создана для обеспечения совместимости с предыдущими версиями программы Visual Basic. Синтаксис функции CVDate аналогичен функции CDate, однако функция CVDate возвращает тип Variant, подтипом которого является Date, а не сам тип Date. Поскольку теперь в программу включен встроенный тип Date, необходимость в функции CVDate отпадает. Того же результата можно добиться, преобразовав выражение в тип Date, и назначив его типу Variant. Этот способ последовательно применяется для преобразования всех остальных встроенных типов в аналогичные им подтипы типа Variant.

Примечание. Функция CDec не возвращает отдельных типов данных; вместо этого она всегда возвращает тип Variant, значения которого преобразованы в подтип Decimal.