Lire en anglais

Partager via


XmlConvert.ToDateTimeOffset Méthode

Définition

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 (string s, string[] formats);

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

É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);
        }
    }
}

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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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 (string s, string format);

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

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

s a la valeur null.

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);
        }
    }
}

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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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 (string s);

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

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

s a la valeur null.

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.

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);
    }
}

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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0