This documentation is archived and is not being maintained.

Return Values for the CStr Function 

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

If expression type is CStr returns

Boolean Data Type (Visual Basic)

A string containing "True" or "False".

Date Data Type (Visual Basic)

A string containing a Date value (date and time) in the short date format of your system.

Numeric Data Types

A 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 Function (Visual Basic).


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 System.Double.ToString(System.IFormatProvider) when converting a value of type Double to a String.