次の方法で共有


XmlConvert.ToDateTimeOffset メソッド

定義

指定した String を等価の DateTimeOffset に変換します。

オーバーロード

ToDateTimeOffset(String, String[])

指定した String を等価の DateTimeOffset に変換します。

ToDateTimeOffset(String, String)

指定した String を等価の DateTimeOffset に変換します。

ToDateTimeOffset(String)

指定した String を等価の DateTimeOffset に変換します。

ToDateTimeOffset(String, String[])

指定した String を等価の 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

パラメーター

s
String

変換する文字列。

formats
String[]

s に変換可能な形式の配列。 formats の各形式には、W3C 勧告の XML dateTime 型の任意のサブセットを指定できます。 (詳細については、XML スキーマ仕様の dateTime セクションを参照してください。)文字列 s は、これらの形式のいずれかに対して妥当性が検査されます。

戻り値

DateTimeOffset

指定した文字列と等価の DateTimeOffset

次の例では、XML ファイルから文字列を読み取り、そのメソッドを ToDateTimeOffset 使用して文字列を型に変換する方法を 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();

        // 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

この例では、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>  

注釈

入力文字列内で指定されたオフセットによって DateTimeOffset の逆シリアル化表現がオーバーフローする場合は、FormatException がスローされます。

秒の小数部に 7 桁を超える数字を指定すると、値は丸められます。 たとえば、00000004は 0000000 になり、00000005は0000001になります。

適用対象

ToDateTimeOffset(String, String)

指定した String を等価の 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

パラメーター

s
String

変換する文字列。

format
String

変換前の s の形式。 フォーマット パラメーターには、W3C 勧告の XML dateTime 型の任意のサブセットを指定できます。 (詳細については、XML スキーマ仕様の dateTime セクションを参照してください。)文字列 s はこの形式に対して妥当性が検査されます。

戻り値

DateTimeOffset

指定した文字列と等価の DateTimeOffset

例外

snullです。

s または format が空の文字列です。または指定された形式ではありません。

次の例では、XML ファイルから文字列を読み取り、そのメソッドを ToDateTimeOffset 使用して文字列を型に変換する方法を 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();

        // 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

この例では、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>  

注釈

入力文字列内で指定されたオフセットによって DateTimeOffset の逆シリアル化表現がオーバーフローする場合は、FormatException がスローされます。

秒の小数部に 7 桁を超える数字を指定すると、値は丸められます。 たとえば、00000004は 0000000 になり、00000005は0000001になります。

適用対象

ToDateTimeOffset(String)

指定した String を等価の 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

パラメーター

s
String

変換する文字列。 文字列は、XML dateTime 型の W3C Recommendation のサブセットに準拠している必要があります。 詳細については、XML スキーマ仕様の dateTime セクションを参照してください。

戻り値

DateTimeOffset

指定した文字列と等価の DateTimeOffset

例外

snullです。

このメソッドに渡した引数が、許容値の範囲外にあります。 許容値については、DateTimeOffset を参照してください。

このメソッドに渡した引数が、W3C 勧告の XML dateTime 型のサブセットに準拠していません。 詳細については、XML スキーマ仕様の dateTime セクションを参照してください。

次の例では、XML ファイルから文字列を読み取り、そのメソッドを ToDateTimeOffset 使用して文字列を型に変換する方法を 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

この例では、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>  

注釈

秒の小数部に 7 桁を超える数字を指定すると、値は丸められます。 たとえば、00000004は 0000000 になり、00000005は0000001になります。

適用対象