XmlConvert.ToDateTimeOffset Méthode

Définition

Espace de noms:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Convertit le fourni String en DateTimeOffset équivalent.

Surcharges

Nom	Description
ToDateTimeOffset(String, String[])	Convertit le fourni String en DateTimeOffset équivalent.
ToDateTimeOffset(String, String)	Convertit le fourni String en DateTimeOffset équivalent.
ToDateTimeOffset(String)	Convertit le fourni String en DateTimeOffset équivalent.

ToDateTimeOffset(String, String[])

Convertit le fourni String en DateTimeOffset équivalent.

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

Paramètres

s: String

La chaîne à convertir.

formats: String[]

Tableau de formats à partir duquel il est possible de s les convertir. Chaque format formats peut être n’importe quel sous-ensemble de la recommandation W3C pour le type dateTime XML. (Pour plus d’informations, consultez la section dateTime de la spécification du schéma XML.) La chaîne s est validée par rapport à l’un de ces formats.

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exemples

L’exemple suivant montre comment lire une chaîne à partir d’un fichier XML et utiliser la ToDateTimeOffset méthode pour convertir la chaîne en type DateTimeOffset . La chaîne d’entrée doit être validée par rapport à l’un des formats spécifiés avant d’être convertie.

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

L’exemple utilise le fichier 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>

Remarques

Si le décalage spécifié dans la chaîne d’entrée entraîne un dépassement de capacité dans la représentation désérialisée de DateTimeOffset, une exception FormatException est levée.

Lorsque plus de sept chiffres sont spécifiés pendant des fractions de secondes, la valeur est arrondie. Par exemple, 00000004 devient 00000000 et 00000005 devient 0000001.

S’applique à

ToDateTimeOffset(String, String)

Convertit le fourni String en DateTimeOffset équivalent.

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

Paramètres

s: String

La chaîne à convertir.

format: String

Format à partir duquel s est converti. Le paramètre de format peut être n’importe quel sous-ensemble de la recommandation W3C pour le type dateTime XML. (Pour plus d’informations, consultez la section dateTime de la spécification du schéma XML.) La chaîne s est validée par rapport à ce format.

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

ArgumentNullException

s a la valeur null.

FormatException

s ou format est une chaîne vide ou n’est pas au format spécifié.

Exemples

L’exemple suivant montre comment lire une chaîne à partir d’un fichier XML et utiliser la ToDateTimeOffset méthode pour convertir la chaîne en type DateTimeOffset . La chaîne d’entrée est validée par rapport au format spécifié avant d’être convertie.

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

L’exemple utilise le fichier 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>

Remarques

Si le décalage spécifié dans la chaîne d’entrée entraîne un dépassement de capacité dans la représentation désérialisée de DateTimeOffset, une exception FormatException est levée.

Lorsque plus de sept chiffres sont spécifiés pendant des fractions de secondes, la valeur est arrondie. Par exemple, 00000004 devient 00000000 et 00000005 devient 0000001.

S’applique à

ToDateTimeOffset(String)

Convertit le fourni String en DateTimeOffset équivalent.

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

Paramètres

s: String

La chaîne à convertir. La chaîne doit être conforme à un sous-ensemble de la recommandation W3C pour le type dateTime XML. Pour plus d’informations, consultez la section dateTime de la spécification du schéma XML.

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

ArgumentNullException

s a la valeur null.

ArgumentOutOfRangeException

L’argument passé à cette méthode est en dehors de la plage de valeurs autorisées. Pour plus d’informations sur les valeurs autorisées, consultez DateTimeOffset.

FormatException

L’argument passé à cette méthode n’est pas conforme à un sous-ensemble des recommandations W3C pour le type dateTime XML. Pour plus d’informations, consultez la section dateTime de la spécification du schéma XML.

Exemples

L’exemple suivant montre comment lire une chaîne à partir d’un fichier XML et utiliser la ToDateTimeOffset méthode pour convertir la chaîne en type DateTimeOffset .

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

L’exemple utilise le fichier 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>

Remarques

Lorsque plus de sept chiffres sont spécifiés pendant des fractions de secondes, la valeur est arrondie. Par exemple, 00000004 devient 00000000 et 00000005 devient 0000001.

S’applique à

Commentaires

Cette page a-t-elle été utile ?