XmlConvert.ToDateTimeOffset Méthode

  • Référence

Définition

Espace de noms:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

Surcharges

ToDateTimeOffset(String, String[])

Convertit la chaîne String fournie en un équivalent DateTimeOffset.
ToDateTimeOffset(String, String)

Convertit la chaîne String fournie en un équivalent DateTimeOffset.
ToDateTimeOffset(String)

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

ToDateTimeOffset(String, String[])

Source:
XmlConvert.cs
Source:
XmlConvert.cs
Source:
XmlConvert.cs

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

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

Chaîne à convertir.

formats
String[]

Tableau de formats à partir duquel s peut être convertie. Chaque format figurant dans formats peut correspondre à un des sous-ensembles de la recommandation W3C pour le type XML dateTime. (Pour plus d’informations, consultez la section dateTime de la spécification XML Schema.) 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 provoque 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)

Source:
XmlConvert.cs
Source:
XmlConvert.cs
Source:
XmlConvert.cs

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

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

Chaîne à convertir.

format
String

Format à partir duquel s est convertie. Le paramètre de format peut correspondre à un sous-ensemble de recommandations du W3C pour le type XML dateTime. (Pour plus d’informations, consultez la section dateTime de la spécification XML Schema.) 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 et n'est pas dans le 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 provoque 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)

Source:
XmlConvert.cs
Source:
XmlConvert.cs
Source:
XmlConvert.cs

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

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

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

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

ArgumentNullException

s a la valeur null.

ArgumentOutOfRangeException

L'argument passé à cette méthode se trouve 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 de recommandations du W3C sur le type XML dateTime. Pour plus d’informations, consultez la section dateTime de la spécification XML Schema.

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 à