XmlConvert.ToDateTime 方法

定义

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

重载

ToDateTime(String)
已过时。

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

ToDateTime(String, String)

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

ToDateTime(String, String[])

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

ToDateTime(String, XmlDateTimeSerializationMode)

使用指定的 XmlDateTimeSerializationModeString 转换为 DateTimeConverts the String to a DateTime using the XmlDateTimeSerializationMode specified.

ToDateTime(String)

注意

Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

public:
 static DateTime ToDateTime(System::String ^ s);
[System.Obsolete("Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode")]
public static DateTime ToDateTime (string s);
public static DateTime ToDateTime (string s);
[<System.Obsolete("Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode")>]
static member ToDateTime : string -> DateTime
static member ToDateTime : string -> DateTime
Public Shared Function ToDateTime (s As String) As DateTime

参数

s
String

要转换的字符串。The string to convert.

返回

DateTime

与该字符串等效的 DateTimeA DateTime equivalent of the string.

属性

例外

snulls is null.

s 为空字符串或格式不正确。s is an empty string or is not in the correct format.

示例

下面的示例使用 ToDoubleToDateTime 读取强类型数据。The following example uses ToDouble and ToDateTime to read strongly typed data.

#using <System.dll>
#using <System.xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = gcnew XmlTextReader( "orderData.xml" );
   
   //Parse the file and pull out the order date and price.
   while ( reader->Read() )
   {
      if ( reader->NodeType == XmlNodeType::Element )
      {
         if ( reader->Name->Equals( "order" ) )
         {
            DateTime orderDate = XmlConvert::ToDateTime( reader->GetAttribute( "date" ) );
            Console::WriteLine( "order date: {0}", orderDate.ToString() );
         }
         else
         if ( reader->Name->Equals( "price" ) )
         {
            Double price = XmlConvert::ToDouble( reader->ReadInnerXml() );
            Console::WriteLine( "price: {0}", price );
         }
      }
   }

   
   //Close the reader.
   reader->Close();
}

using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {
    XmlTextReader reader = new XmlTextReader("orderData.xml");

    //Parse the file and pull out the order date and price.
    while (reader.Read()){
       if (reader.NodeType==XmlNodeType.Element){
         switch(reader.Name){
           case "order":
             DateTime orderDate = XmlConvert.ToDateTime(reader.GetAttribute("date"));
             Console.WriteLine("order date: {0}", orderDate.ToString());
             break;
           case "price":
             Double price = XmlConvert.ToDouble(reader.ReadInnerXml());
             Console.WriteLine("price: {0}", price.ToString());
             break;
         }
       }
    }

    //Close the reader.
    reader.Close();
  }
}
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    Dim reader as XmlTextReader = new XmlTextReader("orderData.xml")

    'Parse the file and pull out the order date and price.
    while (reader.Read())
       if (reader.NodeType=XmlNodeType.Element)
         select case reader.Name
           case "order":
             Dim orderDate as DateTime = XmlConvert.ToDateTime(reader.GetAttribute("date"))
             Console.WriteLine("order date: {0}", orderDate.ToString())
           case "price":
             Dim price as Double = XmlConvert.ToDouble(reader.ReadInnerXml())
             Console.WriteLine("price: {0}", price.ToString())
         end select
       end if
    end while

    'Close the reader.
    reader.Close()  
  end sub
end class

该示例使用文件 orderData.xml 作为输入。The example uses the file, orderData.xml, as input.

<order date="2001-05-03">
  <orderID>367A54</orderID>
  <custID>32632</custID>
  <price>19.95</price>
</order>

注解

备注

XmlConvert.ToDateTime(String) 方法在 .NET Framework 的2.0 版本中已过时,已被 XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) 方法替换。The XmlConvert.ToDateTime(String) method is obsolete in the 2.0 version of the .NET Framework and has been replaced by the XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) method.

适用于

ToDateTime(String, String)

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

public:
 static DateTime ToDateTime(System::String ^ s, System::String ^ format);
public static DateTime ToDateTime (string s, string format);
static member ToDateTime : string * string -> DateTime
Public Shared Function ToDateTime (s As String, format As String) As DateTime

参数

s
String

要转换的字符串。The string to convert.

format
String

该格式结构适用于转换的 DateTimeThe format structure to apply to the converted DateTime. 有效格式包括“yyyy-MM-ddTHH:mm:sszzzzzz”及其子集。Valid formats include "yyyy-MM-ddTHH:mm:sszzzzzz" and its subsets. 根据此格式验证字符串。The string is validated against this format.

返回

DateTime

与该字符串等效的 DateTimeA DateTime equivalent of the string.

例外

snulls is null.

sformat 为 String.Emptys or format is String.Empty - 或 --or- s 不包含与 format 对应的日期和时间。s does not contain a date and time that corresponds to format.

适用于

ToDateTime(String, String[])

String 转换为等效的 DateTimeConverts the String to a DateTime equivalent.

public:
 static DateTime ToDateTime(System::String ^ s, cli::array <System::String ^> ^ formats);
public static DateTime ToDateTime (string s, string[] formats);
static member ToDateTime : string * string[] -> DateTime
Public Shared Function ToDateTime (s As String, formats As String()) As DateTime

参数

s
String

要转换的字符串。The string to convert.

formats
String[]

包含格式结构的数组,这些格式结构适用于转换的 DateTimeAn array containing the format structures to apply to the converted DateTime. 有效格式包括“yyyy-MM-ddTHH:mm:sszzzzzz”及其子集。Valid formats include "yyyy-MM-ddTHH:mm:sszzzzzz" and its subsets.

返回

DateTime

与该字符串等效的 DateTimeA DateTime equivalent of the string.

例外

snulls is null.

sformats 的一个元素为 String.Emptys or an element of formats is String.Empty - 或 --or- s 不包含与 formats 的任何元素对应的日期和时间。s does not contain a date and time that corresponds to any of the elements of formats.

注解

此方法允许验证字符串的多种格式。This method allows multiple formats for the string to be validated against.

适用于

ToDateTime(String, XmlDateTimeSerializationMode)

使用指定的 XmlDateTimeSerializationModeString 转换为 DateTimeConverts the String to a DateTime using the XmlDateTimeSerializationMode specified.

public:
 static DateTime ToDateTime(System::String ^ s, System::Xml::XmlDateTimeSerializationMode dateTimeOption);
public static DateTime ToDateTime (string s, System.Xml.XmlDateTimeSerializationMode dateTimeOption);
static member ToDateTime : string * System.Xml.XmlDateTimeSerializationMode -> DateTime
Public Shared Function ToDateTime (s As String, dateTimeOption As XmlDateTimeSerializationMode) As DateTime

参数

s
String

要转换的 String 值。The String value to convert.

dateTimeOption
XmlDateTimeSerializationMode

枚举值之一,用于指定日期是应转换为本地时间,还是应保留为协调通用时间 (UTC)(如果它为 UTC 日期)。One of the enumeration values that specify whether the date should be converted to local time or preserved as Coordinated Universal Time (UTC), if it is a UTC date.

返回

DateTime

DateTime 的等效 StringA DateTime equivalent of the String.

例外

snulls is null.

dateTimeOptionnulldateTimeOption is null.

s 是一个空字符串或其格式无效。s is an empty string or is not in a valid format.

适用于