Returns a Variant (String) representation of a number.
Syntax
Str(number)
The required number argument is a Long that contains any valid numeric expression.
Remarks
When numbers are converted to strings, a leading space is always reserved for the sign of number. If number is positive, the returned string contains a leading space, and the plus sign is implied.
Use the Format function to convert numeric values that you want formatted as dates, times, currency, or other user-defined formats. Unlike Str, the Format function doesn't include a leading space for the sign of number.
Note
The Str function recognizes only the period (.) as a valid decimal separator. When different decimal separators might be used, such as in international applications, use CStr to convert a number to a string.
Query example
| Expression | Results |
|---|---|
SELECT Discount, Str(Discount) AS StrDiscount FROM ProductSales; |
Returns the original Discount values together with values converted to string format in the StrDiscount column. |
VBA example
Note
Examples that follow demonstrate the use of this function in a Visual Basic for Applications (VBA) module. For more information about working with VBA, select Developer Reference in the drop-down list next to Search and enter one or more terms in the search box.
This example uses the Str function to return a string representation of a number. When a number is converted to a string, a leading space is always reserved for its sign.
Dim MyString
MyString = Str(459) ' Returns " 459".
MyString = Str(-459.65) ' Returns "-459.65".
MyString = Str(459.001) ' Returns " 459.001".