ToDateTime()

XmlConvert::ToDateTime(const String&) method

Converts the String to a DateTime equivalent.

static DateTime System::Xml::XmlConvert::ToDateTime(const String &s)

Arguments

ParameterTypeDescription
sconst String&The string to convert.

Return Value

A DateTime equivalent of the string.

Exceptions

ExceptionDescription
ArgumentNullExceptions is nullptr.
FormatExceptions is an empty string or is not in the correct format.

XmlConvert::ToDateTime(const String&, const String&) method

Converts the String to a DateTime equivalent.

static DateTime System::Xml::XmlConvert::ToDateTime(const String &s, const String &format)

Arguments

ParameterTypeDescription
sconst String&The string to convert.
formatconst String&The format structure to apply to the converted DateTime. Valid formats include “yyyy-MM-ddTHH:mm:sszzzzzz” and its subsets. The string is validated against this format.

Return Value

A DateTime equivalent of the string.

Exceptions

ExceptionDescription
ArgumentNullExceptions is nullptr.
FormatExceptions or format is String::Empty or s does not contain a date and time that corresponds to format.

XmlConvert::ToDateTime(const String&, const ArrayPtr<String>&) method

Converts the String to a DateTime equivalent.

static DateTime System::Xml::XmlConvert::ToDateTime(const String &s, const ArrayPtr<String> &formats)

Arguments

ParameterTypeDescription
sconst String&The string to convert.
formatsconst ArrayPtr<String>&An array containing the format structures to apply to the converted DateTime. Valid formats include “yyyy-MM-ddTHH:mm:sszzzzzz” and its subsets.

Return Value

A DateTime equivalent of the string.

Exceptions

ExceptionDescription
ArgumentNullExceptions is nullptr.
FormatExceptions or an element of formats is String::Empty or s does not contain a date and time that corresponds to any of the elements of formats.

XmlConvert::ToDateTime(const String&, XmlDateTimeSerializationMode) method

Converts the String to a DateTime using the XmlDateTimeSerializationMode specified.

static DateTime System::Xml::XmlConvert::ToDateTime(const String &s, XmlDateTimeSerializationMode dateTimeOption)

Arguments

ParameterTypeDescription
sconst String&The String value to convert.
dateTimeOptionXmlDateTimeSerializationModeOne of the enumeration values that specify whether the date should be converted to local time or preserved as Coordinated Universal Time (UTC), if it is a UTC date.

Return Value

A DateTime equivalent of the String.

Exceptions

ExceptionDescription
NullReferenceExceptions is nullptr.
ArgumentNullExceptiondateTimeOption is nullptr.
FormatExceptions is an empty string or is not in a valid format.

See Also