Convert::ToDateTime Method (String^)
Converts the specified string representation of a date and time to an equivalent date and time value.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System::String^
The string representation of a date and time.
Return Value
Type: System::DateTimeThe date and time equivalent of the value of value, or the date and time equivalent of DateTime::MinValue if value is null.
| Exception | Condition |
|---|---|
| FormatException | value is not a properly formatted date and time string. |
If value is not null, the return value is the result of invoking the DateTime::Parse method on value using the formatting information in a DateTimeFormatInfo object that is initialized for the current culture. The value argument must contain the representation of a date and time in one of the formats described in the DateTimeFormatInfo topic. If value is null, the method returns DateTime::MinValue.
This method tries to parse value completely and avoid throwing a FormatException. It completes missing month, day, and year information with the current date. If value contains only a date and no time, this method assumes a time of midnight. Any leading, inner, or trailing white-space characters in value are ignored.
If you prefer not to handle an exception if the conversion fails, you can call the DateTime::TryParsemethod instead. It returns a Boolean value that indicates whether the conversion succeeded or failed.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1