XmlConvert.ToDateTimeOffset Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: System.Xml.dll, System.Xml.ReaderWriter.dll

Sammansättningar:: netstandard.dll, System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Konverterar den angivna String till en DateTimeOffset motsvarighet.

Överlagringar

Name	Description
ToDateTimeOffset(String, String[])	Konverterar den angivna String till en DateTimeOffset motsvarighet.
ToDateTimeOffset(String, String)	Konverterar den angivna String till en DateTimeOffset motsvarighet.
ToDateTimeOffset(String)	Konverterar den angivna String till en DateTimeOffset motsvarighet.

ToDateTimeOffset(String, String[])

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Konverterar den angivna String till en DateTimeOffset motsvarighet.

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

Parametrar

s: String

Sträng som ska konverteras.

formats: String[]

En matris med .NET standard- eller anpassade datum- och tidsformatsträngar som anger de tillåtna formaten för s.

Returer

DateTimeOffset

Motsvarigheten DateTimeOffset till den angivna strängen.

Undantag

FormatException

Ett element formats i är ogiltigt eller s matchar inte exakt något element formats i under de invarianta kulturreglerna, förutom inledande eller avslutande blanksteg.

Exempel

I följande exempel visas hur du läser en sträng från en XML-fil och använder ToDateTimeOffset metoden för att konvertera strängen till en DateTimeOffset typ. Indatasträngen måste verifiera mot ett av de angivna formaten innan den konverteras.

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

I exemplet används filen 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>

Kommentarer

Den här överlagringen motsvarar anropet DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) med DateTimeFormatInfo.InvariantInfo och flaggorna AllowLeadingWhite och AllowTrailingWhite . Inledande och avslutande blanksteg ignoreras, men s måste annars exakt matcha en av strängarna i formats. Parametern formats använder .NET standardformatsträngar för datum och tid eller anpassade datum- och tidsformatsträngar, inte XML Schema dateTime-mönster.

I en anpassad formatsträng zkräver , zzoch zzz -specificerare en signerad numerisk UTC-förskjutning. De matchar inte XML UTC-designatorn Z. Använd den K anpassade formatspecificeraren när s kan innehålla Z.

Om förskjutningen som anges i indatasträngen orsakar ett spill i den deserialiserade representationen av DateTimeOffset genereras en FormatException.

När fler än sju siffror anges för bråksekunder avrundas värdet. Till exempel blir 00000004 00000000 och 00000005 blir 0000001.

Gäller för

ToDateTimeOffset(String, String)

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Konverterar den angivna String till en DateTimeOffset motsvarighet.

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

Parametrar

s: String

Sträng som ska konverteras.

format: String

En .NET standard- eller anpassad datum- och tidsformatsträng som anger det format som krävs för s.

Returer

DateTimeOffset

Motsvarigheten DateTimeOffset till den angivna strängen.

Undantag

ArgumentNullException

s är null.

FormatException

format är ogiltigt eller s matchar format inte exakt under de invarianta kulturreglerna, förutom inledande eller avslutande blanksteg.

Exempel

I följande exempel visas hur du läser en sträng från en XML-fil och använder ToDateTimeOffset metoden för att konvertera strängen till en DateTimeOffset typ. Indatasträngen verifieras mot det angivna formatet innan den konverteras.

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

I exemplet används filen 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>

Kommentarer

Den här överlagringen motsvarar anropet DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) med DateTimeFormatInfo.InvariantInfo och flaggorna AllowLeadingWhite och AllowTrailingWhite . Inledande och avslutande blanksteg ignoreras, men s måste annars exakt matcha format. Parametern format använder .NET standardformatsträngar för datum och tid eller anpassade datum- och tidsformatsträngar, inte XML Schema dateTime-mönster.

Om förskjutningen som anges i indatasträngen orsakar ett spill i den deserialiserade representationen av DateTimeOffset genereras en FormatException.

När fler än sju siffror anges för bråksekunder avrundas värdet. Till exempel blir 00000004 00000000 och 00000005 blir 0000001.

Gäller för

ToDateTimeOffset(String)

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Källa:: XmlConvert.cs

Konverterar den angivna String till en DateTimeOffset motsvarighet.

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

Parametrar

s: String

Sträng som ska konverteras. Strängen måste överensstämma med en delmängd av W3C-rekommendationen för XML dateTime-typen. Mer information finns i avsnittet dateTime i XML-schemaspecifikationen.

Returer

DateTimeOffset

Motsvarigheten DateTimeOffset till den angivna strängen.

Undantag

ArgumentNullException

s är null.

ArgumentOutOfRangeException

Argumentet som skickas till den här metoden ligger utanför intervallet med tillåtna värden. Information om tillåtna värden finns i DateTimeOffset.

FormatException

Argumentet som skickas till den här metoden överensstämmer inte med en delmängd av W3C-rekommendationerna för XML dateTime-typen. Mer information finns i avsnittet dateTime i XML-schemaspecifikationen.

Exempel

I följande exempel visas hur du läser en sträng från en XML-fil och använder ToDateTimeOffset metoden för att konvertera strängen till en DateTimeOffset typ.

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

I exemplet används filen 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>

Kommentarer

När fler än sju siffror anges för bråksekunder avrundas värdet. Till exempel blir 00000004 00000000 och 00000005 blir 0000001.

Gäller för

Feedback

Var den här sidan till hjälp?