Return Values for the CStr Function (Visual Basic)


Updated: July 20, 2015

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

The following table describes the return values for CStr for different data types of expression.

If expression type isCStr returns
Boolean Data TypeA string containing "True" or "False".
Date Data TypeA string containing a Date value (date and time) in the short date format of your system.
Numeric Data TypesA string representing the number.

The Date type always contains both date and time information. For purposes of type conversion, Visual Basic considers 1/1/0001 (January 1 of the year 1) to be a neutral value for the date, and 00:00:00 (midnight) to be a neutral value for the time. CStr does not include neutral values in the resulting string. For example, if you convert #January 1, 0001 9:30:00# to a string, the result is "9:30:00 AM"; the date information is suppressed. However, the date information is still present in the original Date value and can be recovered with functions such as DatePart.

System_CAPS_ICON_note.jpg Note

The CStr function performs its conversion based on the current culture settings for the application. To get the string representation of a number in a particular culture, use the number's ToString(IFormatProvider) method. For example, use Double.ToString when converting a value of type Double to a String.

Type Conversion Functions
Boolean Data Type
Date Data Type