Convert 类

System.Convert.ToDateTime 方法 (Object)

上一篇：System.Convert.ToDateTime(Int64) 方法下一篇：System.Convert.ToDecimal(Boolean) 方法

方法描述

将指定对象的值转换为 DateTime 对象。

语法定义(C# System.Convert.ToDateTime 方法 (Object) 的用法)

public static DateTime ToDateTime(
	Object value
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
value	System-Object	用于实现 IConvertible 接口的对象，或为 null。
返回值	System.DateTime	value 的值的日期和时间等效项，如果 value 为 null，则为 DateTime.MinValue 的日期和时间等效项。

提示和注释

若要使该转换成功，value 参数的运行时类型必须为 DateTime 或 String，或者 value 必须为 null。否则，该方法将引发 InvalidCastException。此外，如果 value 为字符串，则它必须包含当前区域性中日期和时间值的有效表现形式，否则会引发 FormatException。

返回值是调用 value 的基础类型的 IConvertible.ToDateTime 方法的结果。

System.Convert.ToDateTime 方法 (Object)例子

下面的示例使用各种 Object 变量调用 ToDateTime(Object) 方法。

using System;

public class ConversionToDateTime
{
   public static void Main()
   {
      // Try converting an integer.
      int number = 16352;
      ConvertToDateTime(number);

      // Convert a null.
      object obj = null;
      ConvertToDateTime(obj);

      // Convert a non-date string.
      string nonDateString = "monthly";
      ConvertToDateTime(nonDateString);

      // Try to convert various date strings.
      string dateString; 
      dateString = "05/01/1996";
      ConvertToDateTime(dateString);
      dateString = "Tue Apr 28, 2009";
      ConvertToDateTime(dateString);
      dateString = "06 July 2008 7:32:47 AM";
      ConvertToDateTime(dateString);
      dateString = "17:32:47.003";
      ConvertToDateTime(dateString);
   }

   private static void ConvertToDateTime(object value)
   {
      DateTime convertedDate;
      try {
         convertedDate = Convert.ToDateTime(value);
         Console.WriteLine("'{0}' converts to {1}.", value, convertedDate);
      }
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in the proper format.", value);
      }   
      catch (InvalidCastException) {
         Console.WriteLine("Conversion of the {0} '{1}' is not supported", 
                           value.GetType().Name, value);
      }
   }
}
// The example displays the following output:
//       Conversion of the Int32 '16352' is not supported
//       '' converts to 1/1/0001 12:00:00 AM.
//       'monthly' is not in the proper format.
//       '05/01/1996' converts to 5/1/1996 12:00:00 AM.
//       'Tue Apr 28, 2009' converts to 4/28/2009 12:00:00 AM.
//       '06 July 2008 7:32:47 AM' converts to 7/6/2008 7:32:47 AM.
//       '17:32:47.003' converts to 5/28/2008 5:32:47 PM.

异常

异常	异常描述
FormatException	value不是有效的日期和时间值。
InvalidCastException	value 不实现 IConvertible 接口。不支持该转换。

命名空间

namespace: System

程序集: mscorlib（在 mscorlib.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1 受以下版本支持：

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。