XmlConvert.ToDateTime Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Converte o String em um DateTime equivalente.

Sobrecargas

ToDateTime(String)	Obsoleto. Obsoleto. Converte o String em um DateTime equivalente.
ToDateTime(String, String)	Converte o String em um DateTime equivalente.
ToDateTime(String, String[])	Converte o String em um DateTime equivalente.
ToDateTime(String, XmlDateTimeSerializationMode)	Converte o String em um DateTime usando o XmlDateTimeSerializationMode especificado.

ToDateTime(String)

Cuidado

Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode

Cuidado

Use XmlConvert.ToDateTime() that accepts an XmlDateTimeSerializationMode instead.

Converte o String em um DateTime equivalente.

public:
 static DateTime ToDateTime(System::String ^ s);

[System.Obsolete("Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode")]
public static DateTime ToDateTime (string s);

[System.Obsolete("Use XmlConvert.ToDateTime() that accepts an XmlDateTimeSerializationMode instead.")]
public static DateTime ToDateTime (string s);

public static DateTime ToDateTime (string s);

[<System.Obsolete("Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode")>]
static member ToDateTime : string -> DateTime

[<System.Obsolete("Use XmlConvert.ToDateTime() that accepts an XmlDateTimeSerializationMode instead.")>]
static member ToDateTime : string -> DateTime

static member ToDateTime : string -> DateTime

Public Shared Function ToDateTime (s As String) As DateTime

Parâmetros

s

String

A cadeia de caracteres a ser convertida.

Retornos

DateTime

Um DateTime equivalente da cadeia de caracteres.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

s é null.

FormatException

s é uma cadeia de caracteres vazia ou não está no formato correto.

Exemplos

O exemplo a seguir usa ToDouble e ToDateTime para ler dados fortemente tipado.

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

O exemplo usa o arquivo, orderData.xmlcomo entrada.

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

Comentários

Observação

O XmlConvert.ToDateTime(String) método é obsoleto na versão 2.0 do .NET Framework e foi substituído pelo XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) método.

ToDateTime(String, String)

Converte o String em um DateTime equivalente.

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

Parâmetros

s

String

A cadeia de caracteres a ser convertida.

format

String

A estrutura de formato a ser aplicada ao DateTime convertido. Os formatos válidos incluem “aaaa-MM-ddTHH:mm:sszzzzzz” e seus subconjuntos. A cadeia de caracteres é validada em relação a esse formato.

Retornos

DateTime

Um DateTime equivalente da cadeia de caracteres.

Exceções

ArgumentNullException

s é null.

FormatException

s ou format é String.Empty - ou - s não contém uma data e hora que corresponde ao format.

ToDateTime(String, String[])

Converte o String em um DateTime equivalente.

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

Parâmetros

s

String

A cadeia de caracteres a ser convertida.

formats

String[]

Uma matriz que contém as estruturas de formato a serem aplicadas ao DateTime convertido. Os formatos válidos incluem “aaaa-MM-ddTHH:mm:sszzzzzz” e seus subconjuntos.

Retornos

DateTime

Um DateTime equivalente da cadeia de caracteres.

Exceções

ArgumentNullException

s é null.

FormatException

s ou um elemento de formats é String.Empty - ou - s não contém uma data e hora que corresponda a um dos elementos de formats.

Comentários

Esse método permite que vários formatos para a cadeia de caracteres sejam validados.

ToDateTime(String, XmlDateTimeSerializationMode)

Converte o String em um DateTime usando o XmlDateTimeSerializationMode especificado.

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

Parâmetros

s

String

O valor String a ser convertido.

dateTimeOption

XmlDateTimeSerializationMode

Um dos valores de enumeração que especifica se a data deve ser convertida em hora local ou preservada como UTC (Tempo Universal Coordenado), em caso de data UTC.

Retornos

DateTime

Um equivalente de DateTime do String.

Exceções

NullReferenceException

s é null.

ArgumentNullException

dateTimeOption é null.

FormatException

s é uma cadeia de caracteres vazia ou não está em um formato válido.