XmlConvert.ToDateTimeOffset Método

Definición

Espacio de nombres:: System.Xml

Ensamblados:: System.Xml.dll, System.Xml.ReaderWriter.dll

Ensamblados:: netstandard.dll, System.Xml.ReaderWriter.dll

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 proporcionado String en un DateTimeOffset equivalente.

Sobrecargas

Nombre	Description
ToDateTimeOffset(String, String[])	Convierte el proporcionado String en un DateTimeOffset equivalente.
ToDateTimeOffset(String, String)	Convierte el proporcionado String en un DateTimeOffset equivalente.
ToDateTimeOffset(String)	Convierte el proporcionado String en un DateTimeOffset equivalente.

ToDateTimeOffset(String, String[])

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Convierte el proporcionado String en un DateTimeOffset equivalente.

public:
 static DateTimeOffset ToDateTimeOffset(System::String ^ s, cli::array <System::String ^> ^ formats);

public static DateTimeOffset ToDateTimeOffset(string s, string[] formats);

static member ToDateTimeOffset : string * string[] -> DateTimeOffset

Public Shared Function ToDateTimeOffset (s As String, formats As String()) As DateTimeOffset

Parámetros

s: String

La cadena que se va a convertir.

formats: String[]

Matriz de .NET cadenas de formato de fecha y hora estándar o personalizadas que especifican los formatos permitidos de s.

Devoluciones

DateTimeOffset

Equivalente DateTimeOffset de la cadena proporcionada.

Excepciones

FormatException

Un elemento de formats no es válido o s no coincide exactamente con ningún elemento de formats en las reglas de referencia cultural invariable, excepto para el espacio en blanco inicial o final.

Ejemplos

En el ejemplo siguiente se muestra cómo leer una cadena de un archivo XML y usar el ToDateTimeOffset método para convertir la cadena en un DateTimeOffset tipo. La cadena de entrada debe validarse con uno de los formatos especificados antes de convertirse.

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create an XmlReader, read to the "time" element, and read contents as type string
        XmlReader reader = XmlReader.Create("transactions.xml");
        reader.ReadToFollowing("time");
        string time = reader.ReadElementContentAsString();

        // Specify formats against which time will be validated before conversion to DateTimeOffset
        // If time does not match one of the specified formats, a FormatException will be thrown.
        // Each specified format must be a subset of the W3C Recommendation for the XML dateTime type
        string[] formats = {"yyyy-MM-ddTHH:mm:sszzzzzzz", "yyyy-MM-ddTHH:mm:ss", "yyyy-MM-dd"};
        try
        {
            // Read the element contents as a string and covert to DateTimeOffset type
            DateTimeOffset transaction_time = XmlConvert.ToDateTimeOffset(time, formats);
            Console.WriteLine(transaction_time);
        }
        catch (Exception e)
        {
            Console.WriteLine(e);
        }
    }
}

Imports System.Xml

Module Module1
    Sub Main()
        ' Create an XmlReader, read to the "time" element, and read contents as type string
        Dim reader As XmlReader = XmlReader.Create("transactions.xml")
        reader.ReadToFollowing("time")
        Dim time As String = reader.ReadElementContentAsString()

        ' Specify formats against which time will be validated before conversion to DateTimeOffset
        ' If time does not match one of the specified formats, a FormatException will be thrown.
        ' Each specified format must be a subset of the W3C Recommendation for the XML dateTime type
        Dim formats As String() = {"yyyy-MM-ddTHH:mm:sszzzzzzz", "yyyy-MM-ddTHH:mm:ss", "yyyy-MM-dd"}
        Try
            ' Read the element contents as a string and covert to DateTimeOffset type
            Dim transaction_time As DateTimeOffset = XmlConvert.ToDateTimeOffset(time, formats)
            Console.WriteLine(transaction_time)
        Catch e As Exception
            Console.WriteLine(e)
        End Try
    End Sub
End Module

En el ejemplo se usa el archivo transactions.xml.

<?xml version="1.0"?>
<transactions>
   <transaction>
      <id>123456789</id>
      <amount>1.00</amount>
      <currency>USD</currency>
      <time>2007-08-03T22:05:13-07:00</time>
   </transaction>
</transactions>

Comentarios

Esta sobrecarga es equivalente a llamar DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) a con DateTimeFormatInfo.InvariantInfo y las AllowLeadingWhite marcas y AllowTrailingWhite . Se omite el espacio en blanco inicial y final, pero s de lo contrario debe coincidir exactamente con una de las cadenas de formats. El formats parámetro usa .NET cadenas de formato de fecha y hora estándar o cadenas de formato de fecha y hora personalizados, no patrones dateTime del esquema XML.

En una cadena de formato personalizado, los zespecificadores , zzy zzz requieren un desplazamiento UTC numérico firmado. No coinciden con el designador ZXML UTC . Use el K especificador de formato personalizado cuando s pueda contener Z.

Si el desplazamiento especificado dentro de la cadena de entrada provocará un desbordamiento en la representación deserializada de DateTimeOffset, se produce una excepción FormatException.

Cuando se especifican más de siete dígitos durante fracciones de segundos, el valor se redondea. Por ejemplo, 00000004 se convierte en 00000000 y 00000005 se convierte en 0000001.

Se aplica a

ToDateTimeOffset(String, String)

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Convierte el proporcionado String en un DateTimeOffset equivalente.

public:
 static DateTimeOffset ToDateTimeOffset(System::String ^ s, System::String ^ format);

public static DateTimeOffset ToDateTimeOffset(string s, string format);

static member ToDateTimeOffset : string * string -> DateTimeOffset

Public Shared Function ToDateTimeOffset (s As String, format As String) As DateTimeOffset

Parámetros

s: String

La cadena que se va a convertir.

format: String

Cadena de formato de fecha y hora estándar o personalizada .NET que especifica el formato necesario de s.

Devoluciones

DateTimeOffset

Equivalente DateTimeOffset de la cadena proporcionada.

Excepciones

ArgumentNullException

s es null.

FormatException

format no es válido o s no coincide format exactamente con las reglas de referencia cultural invariables, excepto para los espacios en blanco iniciales o finales.

Ejemplos

En el ejemplo siguiente se muestra cómo leer una cadena de un archivo XML y usar el ToDateTimeOffset método para convertir la cadena en un DateTimeOffset tipo. La cadena de entrada se valida con el formato especificado antes de convertirse.

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create an XmlReader, read to the "time" element, and read contents as type string
        XmlReader reader = XmlReader.Create("transactions.xml");
        reader.ReadToFollowing("time");
        string time = reader.ReadElementContentAsString();

        // Specify a format against which time will be validated before conversion to DateTimeOffset
        // If time does not match the format, a FormatException will be thrown.
        // The specified format must be a subset of the W3C Recommendation for the XML dateTime type
        string format = "yyyy-MM-ddTHH:mm:sszzzzzzz";
        try
        {
            // Read the element contents as a string and covert to DateTimeOffset type
            DateTimeOffset transaction_time = XmlConvert.ToDateTimeOffset(time, format);
            Console.WriteLine(transaction_time);
        }
        catch(Exception e)
        {
            Console.WriteLine(e);
        }
    }
}

Imports System.Xml

Module Module1      
    Sub Main()
        ' Create an XmlReader, read to the "time" element, and read contents as type string
        Dim reader As XmlReader = XmlReader.Create("transactions.xml")
        reader.ReadToFollowing("time")
        Dim time As String = reader.ReadElementContentAsString()

        ' Specify a format against which time will be validated before conversion to DateTimeOffset
        ' If time does not match the format, a FormatException will be thrown.
        ' The specified format must be a subset of the W3C Recommendation for the XML dateTime type
        Dim format As String = "yyyy-MM-ddTHH:mm:sszzzzzzz"
        Try
            ' Read the element contents as a string and covert to DateTimeOffset type
            Dim transaction_time As DateTimeOffset = XmlConvert.ToDateTimeOffset(time, format)
            Console.WriteLine(transaction_time)
        Catch e As Exception
            Console.WriteLine(e)
        End Try
    End Sub
End Module

En el ejemplo se usa el archivo transactions.xml.

<?xml version="1.0"?>
<transactions>
   <transaction>
      <id>123456789</id>
      <amount>1.00</amount>
      <currency>USD</currency>
      <time>2007-08-03T22:05:13-07:00</time>
   </transaction>
</transactions>

Comentarios

Esta sobrecarga es equivalente a llamar DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) a con DateTimeFormatInfo.InvariantInfo y las AllowLeadingWhite marcas y AllowTrailingWhite . Se omite el espacio en blanco inicial y final, pero s debe coincidir exactamente con format. El format parámetro usa .NET cadenas de formato de fecha y hora estándar o cadenas de formato de fecha y hora personalizados, no patrones dateTime del esquema XML.

Si el desplazamiento especificado dentro de la cadena de entrada provocará un desbordamiento en la representación deserializada de DateTimeOffset, se produce una excepción FormatException.

Cuando se especifican más de siete dígitos durante fracciones de segundos, el valor se redondea. Por ejemplo, 00000004 se convierte en 00000000 y 00000005 se convierte en 0000001.

Se aplica a

ToDateTimeOffset(String)

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Convierte el proporcionado String en un DateTimeOffset equivalente.

public:
 static DateTimeOffset ToDateTimeOffset(System::String ^ s);

public static DateTimeOffset ToDateTimeOffset(string s);

static member ToDateTimeOffset : string -> DateTimeOffset

Public Shared Function ToDateTimeOffset (s As String) As DateTimeOffset

Parámetros

s: String

La cadena que se va a convertir. La cadena debe ajustarse a un subconjunto de la recomendación W3C para el tipo dateTime XML. Para obtener más información, vea la sección dateTime de la especificación del esquema XML.

Devoluciones

DateTimeOffset

Equivalente DateTimeOffset de la cadena proporcionada.

Excepciones

ArgumentNullException

s es null.

ArgumentOutOfRangeException

El argumento pasado a este método está fuera del intervalo de valores permitidos. Para obtener información sobre los valores permitidos, vea DateTimeOffset.

FormatException

El argumento pasado a este método no se ajusta a un subconjunto de las recomendaciones de W3C para el tipo dateTime XML. Para obtener más información, vea la sección dateTime de la especificación del esquema XML.

Ejemplos

En el ejemplo siguiente se muestra cómo leer una cadena de un archivo XML y usar el ToDateTimeOffset método para convertir la cadena en un DateTimeOffset tipo.

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create an XmlReader, read to the "time" element, and read contents as type string
        XmlReader reader = XmlReader.Create("transactions.xml");
        reader.ReadToFollowing("time");
        string time = reader.ReadElementContentAsString();

        // Read the element contents as a string and covert to DateTimeOffset type
        // The format of time must be a subset of the W3C Recommendation for the XML dateTime type
        DateTimeOffset transaction_time = XmlConvert.ToDateTimeOffset(time);
        Console.WriteLine(transaction_time);
    }
}

Imports System.Xml

Module Module1
    Sub Main()
        ' Create an XmlReader, read to the "time" element, and read contents as type string
        Dim reader As XmlReader = XmlReader.Create("transactions.xml")
        reader.ReadToFollowing("time")
        Dim time As String = reader.ReadElementContentAsString()

        ' Read the element contents as a string and covert to DateTimeOffset type
    ' The format of time must be a subset of the W3C Recommendation for the XML dateTime type
        Dim transaction_time As DateTimeOffset = XmlConvert.ToDateTimeOffset(time)
        Console.WriteLine(transaction_time)
    End Sub
End Module

En el ejemplo se usa el archivo transactions.xml.

<?xml version="1.0"?>
<transactions>
   <transaction>
      <id>123456789</id>
      <amount>1.00</amount>
      <currency>USD</currency>
      <time>2007-08-03T22:05:13-07:00</time>
   </transaction>
</transactions>

Comentarios

Cuando se especifican más de siete dígitos durante fracciones de segundos, el valor se redondea. Por ejemplo, 00000004 se convierte en 00000000 y 00000005 se convierte en 0000001.

Se aplica a

Comentarios

¿Le ha resultado útil esta página?