XmlConvert.ToDateTime XmlConvert.ToDateTime XmlConvert.ToDateTime XmlConvert.ToDateTime Method

Definition

Converts the String to a DateTime equivalent.

Overloads

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

Converts the String to a DateTime equivalent.

ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String)

Converts the String to a DateTime equivalent.

ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[])

Converts the String to a DateTime equivalent.

ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode)

Converts the String to a DateTime using the XmlDateTimeSerializationMode specified

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

Warning

This API is now obsolete.

Converts the String to a DateTime equivalent.

public:
 static DateTime ToDateTime(System::String ^ s);
[System.Obsolete("Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode")]
public static DateTime ToDateTime (string s);
static member ToDateTime : string -> DateTime
Public Shared Function ToDateTime (s As String) As DateTime

Parameters

s
String String String String

The string to convert.

Returns

A DateTime equivalent of the string.

Exceptions

s is an empty string or is not in the correct format.

Examples

The following example uses ToDouble and ToDateTime to read strongly typed data.

#using <System.dll>
#using <System.xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = gcnew XmlTextReader( "orderData.xml" );
   
   //Parse the file and pull out the order date and price.
   while ( reader->Read() )
   {
      if ( reader->NodeType == XmlNodeType::Element )
      {
         if ( reader->Name->Equals( "order" ) )
         {
            DateTime orderDate = XmlConvert::ToDateTime( reader->GetAttribute( "date" ) );
            Console::WriteLine( "order date: {0}", orderDate.ToString() );
         }
         else
         if ( reader->Name->Equals( "price" ) )
         {
            Double price = XmlConvert::ToDouble( reader->ReadInnerXml() );
            Console::WriteLine( "price: {0}", price );
         }
      }
   }

   
   //Close the reader.
   reader->Close();
}

using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {
    XmlTextReader reader = new XmlTextReader("orderData.xml");

    //Parse the file and pull out the order date and price.
    while (reader.Read()){
       if (reader.NodeType==XmlNodeType.Element){
         switch(reader.Name){
           case "order":
             DateTime orderDate = XmlConvert.ToDateTime(reader.GetAttribute("date"));
             Console.WriteLine("order date: {0}", orderDate.ToString());
             break;
           case "price":
             Double price = XmlConvert.ToDouble(reader.ReadInnerXml());
             Console.WriteLine("price: {0}", price.ToString());
             break;
         }
       }
    }

    //Close the reader.
    reader.Close();  
  }
}
Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    Dim reader as XmlTextReader = new XmlTextReader("orderData.xml")

    'Parse the file and pull out the order date and price.
    while (reader.Read())
       if (reader.NodeType=XmlNodeType.Element)
         select case reader.Name
           case "order":
             Dim orderDate as DateTime = XmlConvert.ToDateTime(reader.GetAttribute("date"))
             Console.WriteLine("order date: {0}", orderDate.ToString())
           case "price":
             Dim price as Double = XmlConvert.ToDouble(reader.ReadInnerXml())
             Console.WriteLine("price: {0}", price.ToString())
         end select
       end if
    end while

    'Close the reader.
    reader.Close()  
  end sub
end class

The example uses the file, orderData.xml, as input.

<order date="2001-05-03">
  <orderID>367A54</orderID>
  <custID>32632</custID>
  <price>19.95</price>
</order>

Remarks

Note

The XmlConvert.ToDateTime(String) method is obsolete in the 2.0 version of the .NET Framework and has been replaced by the XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) method.

ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String)

Converts the String to a DateTime equivalent.

public:
 static DateTime ToDateTime(System::String ^ s, System::String ^ format);
public static DateTime ToDateTime (string s, string format);
static member ToDateTime : string * string -> DateTime
Public Shared Function ToDateTime (s As String, format As String) As DateTime

Parameters

s
String String String String

The string to convert.

format
String String String 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.

Returns

A DateTime equivalent of the string.

Exceptions

s or format is String.Empty

-or-

s does not contain a date and time that corresponds to format.

ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[])

Converts the String to a DateTime equivalent.

public:
 static DateTime ToDateTime(System::String ^ s, cli::array <System::String ^> ^ formats);
public static DateTime ToDateTime (string s, string[] formats);
static member ToDateTime : string * string[] -> DateTime
Public Shared Function ToDateTime (s As String, formats As String()) As DateTime

Parameters

s
String String String String

The string to convert.

formats
String[]

An array containing the format structures to apply to the converted DateTime. Valid formats include "yyyy-MM-ddTHH:mm:sszzzzzz" and its subsets.

Returns

A DateTime equivalent of the string.

Exceptions

s 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.

Remarks

This method allows multiple formats for the string to be validated against.

ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode)

Converts the String to a DateTime using the XmlDateTimeSerializationMode specified

public:
 static DateTime ToDateTime(System::String ^ s, System::Xml::XmlDateTimeSerializationMode dateTimeOption);
public static DateTime ToDateTime (string s, System.Xml.XmlDateTimeSerializationMode dateTimeOption);
static member ToDateTime : string * System.Xml.XmlDateTimeSerializationMode -> DateTime
Public Shared Function ToDateTime (s As String, dateTimeOption As XmlDateTimeSerializationMode) As DateTime

Parameters

s
String String String String

The String value to convert.

dateTimeOption
XmlDateTimeSerializationMode XmlDateTimeSerializationMode XmlDateTimeSerializationMode XmlDateTimeSerializationMode

One 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.

Returns

Exceptions

s is an empty string or is not in a valid format.

Applies to