XmlConvert.ToDateTime Método

Referencia

Definición

Espacio de nombres:: System.Xml

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Convierte el String en un DateTime equivalente.

Sobrecargas

ToDateTime(String)	Obsoleto. Obsoleto. Convierte el String en un DateTime equivalente.
ToDateTime(String, String)	Convierte el String en un DateTime equivalente.
ToDateTime(String, String[])	Convierte el String en un DateTime equivalente.
ToDateTime(String, XmlDateTimeSerializationMode)	Convierte String en DateTime mediante el XmlDateTimeSerializationMode especificado.

ToDateTime(String)

Precaución

Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode

Precaución

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

Convierte el String en un 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

Cadena que se va a convertir.

Devoluciones

DateTime

Equivalente DateTime de la cadena.

Atributos: ObsoleteAttribute

Excepciones

ArgumentNullException

s es null.

FormatException

s es una cadena vacía o no tiene el formato correcto.

Ejemplos

En el ejemplo siguiente se usa ToDouble y ToDateTime para leer datos fuertemente tipados.

#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

En el ejemplo se usa el archivo , orderData.xmlcomo entrada.

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

Comentarios

Nota

El XmlConvert.ToDateTime(String) método está obsoleto en la versión 2.0 de .NET Framework y se ha reemplazado por el XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) método .

Se aplica a

ToDateTime(String, String)

Convierte el String en un 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

Cadena que se va a convertir.

format: String

Estructura de formato que se va a aplicar al DateTime convertido. Entre los formatos válidos se incluyen "yyyy-MM-ddTHH:mm:sszzzzzz" y sus subconjuntos. La cadena se valida comparándola con este formato.

Devoluciones

DateTime

Equivalente DateTime de la cadena.

Excepciones

ArgumentNullException

s es null.

FormatException

s o format es String.Empty o bien s no contiene ninguna fecha ni hora que se correspondan con format.

Se aplica a

ToDateTime(String, String[])

Convierte el String en un 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

Cadena que se va a convertir.

formats: String[]

Matriz que contiene las estructuras de formato que se van a aplicar al DateTime convertido. Entre los formatos válidos se incluyen "yyyy-MM-ddTHH:mm:sszzzzzz" y sus subconjuntos.

Devoluciones

DateTime

Equivalente DateTime de la cadena.

Excepciones

ArgumentNullException

s es null.

FormatException

s o un elemento de formats es String.Empty o bien s no contiene una fecha y hora que se correspondan con ninguno de los elementos de formats.

Comentarios

Este método permite validar varios formatos para la cadena.

Se aplica a

ToDateTime(String, XmlDateTimeSerializationMode)

Convierte String en DateTime mediante el 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

Valor String que se va a convertir.

dateTimeOption: XmlDateTimeSerializationMode

Uno de los valores de la enumeración que especifican si la fecha debe convertirse a la hora local o mantenerse como hora universal coordinada (UTC), en el caso de que se trate de una fecha de UTC.

Devoluciones

DateTime

DateTime equivalente de la String.

Excepciones

NullReferenceException

s es null.

ArgumentNullException

dateTimeOption es null.

FormatException

s es una cadena vacía o su formato no es válido.

Se aplica a

XmlConvert.ToDateTime Método

Definición

Sobrecargas

ToDateTime(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Se aplica a

ToDateTime(String, String)

Parámetros

Devoluciones

Excepciones

Se aplica a

ToDateTime(String, String[])

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

ToDateTime(String, XmlDateTimeSerializationMode)

Parámetros

Devoluciones

Excepciones

Se aplica a

Recursos adicionales