Convert.ToDateTime Convert.ToDateTime Convert.ToDateTime Convert.ToDateTime Method

정의

지정된 값을 DateTime 값으로 변환합니다.Converts a specified value to a DateTime value.

오버로드

ToDateTime(Single) ToDateTime(Single) ToDateTime(Single) ToDateTime(Single)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

날짜와 시간의 지정된 문자열 표현을 해당하는 날짜와 시간 값으로 변환합니다.Converts the specified string representation of a date and time to an equivalent date and time value.

ToDateTime(UInt16) ToDateTime(UInt16) ToDateTime(UInt16) ToDateTime(UInt16)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(String, IFormatProvider) ToDateTime(String, IFormatProvider) ToDateTime(String, IFormatProvider) ToDateTime(String, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 숫자의 지정된 문자열 표현을 해당하는 날짜와 시간으로 변환합니다.Converts the specified string representation of a number to an equivalent date and time, using the specified culture-specific formatting information.

ToDateTime(UInt64) ToDateTime(UInt64) ToDateTime(UInt64) ToDateTime(UInt64)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Object, IFormatProvider) ToDateTime(Object, IFormatProvider) ToDateTime(Object, IFormatProvider) ToDateTime(Object, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 개체의 값을 DateTime 개체로 변환합니다.Converts the value of the specified object to a DateTime object, using the specified culture-specific formatting information.

ToDateTime(SByte) ToDateTime(SByte) ToDateTime(SByte) ToDateTime(SByte)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(UInt32) ToDateTime(UInt32) ToDateTime(UInt32) ToDateTime(UInt32)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Object) ToDateTime(Object) ToDateTime(Object) ToDateTime(Object)

지정된 개체의 값을 DateTime 개체로 변환합니다.Converts the value of the specified object to a DateTime object.

ToDateTime(Double) ToDateTime(Double) ToDateTime(Double) ToDateTime(Double)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Int32) ToDateTime(Int32) ToDateTime(Int32) ToDateTime(Int32)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Boolean) ToDateTime(Boolean) ToDateTime(Boolean) ToDateTime(Boolean)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Byte) ToDateTime(Byte) ToDateTime(Byte) ToDateTime(Byte)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Char) ToDateTime(Char) ToDateTime(Char) ToDateTime(Char)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Int64) ToDateTime(Int64) ToDateTime(Int64) ToDateTime(Int64)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Decimal) ToDateTime(Decimal) ToDateTime(Decimal) ToDateTime(Decimal)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(Int16) ToDateTime(Int16) ToDateTime(Int16) ToDateTime(Int16)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

ToDateTime(DateTime) ToDateTime(DateTime) ToDateTime(DateTime) ToDateTime(DateTime)

지정된 DateTime 개체를 실제 변환 작업 없이 반환합니다.Returns the specified DateTime object; no actual conversion is performed.

ToDateTime(Single) ToDateTime(Single) ToDateTime(Single) ToDateTime(Single)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(float value);
public static DateTime ToDateTime (float value);
static member ToDateTime : single -> DateTime
Public Shared Function ToDateTime (value As Single) As DateTime

매개 변수

value
Single Single Single Single

변환할 단정밀도 부동 소수점 값입니다.The single-precision floating-point value to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

날짜와 시간의 지정된 문자열 표현을 해당하는 날짜와 시간 값으로 변환합니다.Converts the specified string representation of a date and time to an equivalent date and time value.

public:
 static DateTime ToDateTime(System::String ^ value);
public static DateTime ToDateTime (string value);
static member ToDateTime : string -> DateTime
Public Shared Function ToDateTime (value As String) As DateTime

매개 변수

value
String String String String

날짜 및 시간의 문자열 표현입니다.The string representation of a date and time.

반환

value의 값에 해당하는 날짜와 시간이거나, MinValuevalue이면 null에 해당하는 날짜와 시간입니다.The date and time equivalent of the value of value, or the date and time equivalent of MinValue if value is null.

예외

value가 올바른 형식의 날짜 및 시간 문자열이 아닙니다.value is not a properly formatted date and time string.

예제

다음 예제에서는 합니다 ToDateTime 날짜 및 시간을 다양 한 문자열 표현으로 변환할 방법이 DateTime 값입니다.The following example uses the ToDateTime method to convert various string representations of dates and times to DateTime values.

using System;

public class ConversionToDateTime
{
   public static void Main()
   {
      string dateString = null;
      
      // Convert a null string.
      ConvertToDateTime(dateString);
      
      // Convert an empty string.
      dateString = String.Empty;
      ConvertToDateTime(dateString);
      
      // Convert a non-date string.
      dateString = "not a date";
      ConvertToDateTime(dateString);
      
      // Try to convert various date strings.
      dateString = "05/01/1996";
      ConvertToDateTime(dateString);
      dateString = "Tue Apr 28, 2009";
      ConvertToDateTime(dateString);
      dateString = "Wed Apr 28, 2009";
      ConvertToDateTime(dateString);
      dateString = "06 July 2008 7:32:47 AM";
      ConvertToDateTime(dateString);
      dateString = "17:32:47.003";
      ConvertToDateTime(dateString);
      // Convert a string returned by DateTime.ToString("R").
      dateString = "Sat, 10 May 2008 14:32:17 GMT";
      ConvertToDateTime(dateString);
      // Convert a string returned by DateTime.ToString("o").
      dateString = "2009-05-01T07:54:59.9843750-04:00";
      ConvertToDateTime(dateString);
   }

   private static void ConvertToDateTime(string value)
   {
      DateTime convertedDate;
      try {
         convertedDate = Convert.ToDateTime(value);
         Console.WriteLine("'{0}' converts to {1} {2} time.", 
                           value, convertedDate, 
                           convertedDate.Kind.ToString());
      }
      catch (FormatException) {
         Console.WriteLine("'{0}' is not in the proper format.", value);
      }
   }
}
// The example displays the following output:
//    '' converts to 1/1/0001 12:00:00 AM Unspecified time.
//    '' is not in the proper format.
//    'not a date' is not in the proper format.
//    '05/01/1996' converts to 5/1/1996 12:00:00 AM Unspecified time.
//    'Tue Apr 28, 2009' converts to 4/28/2009 12:00:00 AM Unspecified time.
//    'Wed Apr 28, 2009' is not in the proper format.
//    '06 July 2008 7:32:47 AM' converts to 7/6/2008 7:32:47 AM Unspecified time.
//    '17:32:47.003' converts to 5/30/2008 5:32:47 PM Unspecified time.
//    'Sat, 10 May 2008 14:32:17 GMT' converts to 5/10/2008 7:32:17 AM Local time.
//    '2009-05-01T07:54:59.9843750-04:00' converts to 5/1/2009 4:54:59 AM Local time.
Module ConversionToDateTime
   Public Sub Main()
      Dim dateString As String = Nothing
      
      ' Convert a null string.
      ConvertToDateTime(dateString)
      
      ' Convert an empty string.
      dateString = String.Empty
      ConvertToDateTime(dateString)
      
      ' Convert a non-date string.
      dateString = "not a date"
      ConvertToDateTime(dateString)
      
      ' Try to convert various date strings.
      dateString = "05/01/1996"
      ConvertToDateTime(dateString)
      dateString = "Tue Apr 28, 2009"
      ConvertToDateTime(dateString)
      dateString = "Wed Apr 28, 2009"
      ConvertToDateTime(dateString)
      dateString = "06 July 2008 7:32:47 AM"
      ConvertToDateTime(dateString)
      dateString = "17:32:47.003"
      ConvertToDateTime(dateString)
      ' Convert a string returned by DateTime.ToString("R").
      dateString = "Sat, 10 May 2008 14:32:17 GMT"
      ConvertToDateTime(dateString)
      ' Convert a string returned by DateTime.ToString("o")
      dateString = "2009-05-01T07:54:59.9843750-04:00"
      ConvertToDateTime(dateString)
   End Sub
   
   Private Sub ConvertToDateTime(value As String)
      Dim convertedDate As Date
      Try
         convertedDate = Convert.ToDateTime(value)
         Console.WriteLine("'{0}' converts to {1}.", value, convertedDate)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in the proper format.", value)
      End Try
   End Sub
End Module
' The example displays the following output:
'    '' converts to 1/1/0001 12:00:00 AM.
'    '' is not in the proper format.
'    'not a date' 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.
'    'Wed Apr 28, 2009' is not in the proper format.
'    '06 July 2008 7:32:47 AM' converts to 7/6/2008 7:32:47 AM.
'    '17:32:47.003' converts to 5/30/2008 5:32:47 PM.
'    'Sat, 10 May 2008 14:32:17 GMT' converts to 5/10/2008 7:32:17 AM.
'    '2009-05-01T07:54:59.9843750-04:00' converts to 5/1/2009 4:54:59 AM.

설명

경우 value 아닙니다 null, 반환 값은 호출의 결과 DateTime.Parse 메서드를 value 의 형식 지정 정보를 사용 하 여는 DateTimeFormatInfo 현재 문화권에 대 한 초기화 되는 개체입니다.If value is not null, the return value is the result of invoking the DateTime.Parse method on value using the formatting information in a DateTimeFormatInfo object that is initialized for the current culture. value 인수가 날짜의 표현이 있어야 합니다. 트리에 대 한 시간 형식 중 하나에서 설명 된 DateTimeFormatInfo 항목.The value argument must contain the representation of a date and time in one of the formats described in the DateTimeFormatInfo topic. valuenull이면 메서드에서 DateTime.MinValue을 반환합니다.If value is null, the method returns DateTime.MinValue.

이 메서드는 구문 분석 하려고 value 완전히 throw 하지 않습니다는 FormatException합니다.This method tries to parse value completely and avoid throwing a FormatException. 누락 된 월, 일 및 연도 정보는 현재 날짜를 완료합니다.It completes missing month, day, and year information with the current date. 경우 value 날짜만 있고 시간이 포함이 메서드는 시간을 자정 가정 합니다.If value contains only a date and no time, this method assumes a time of midnight. 내부 조인, 선행 또는 후행 공백 문자 value 무시 됩니다.Any leading, inner, or trailing white-space characters in value are ignored.

변환에 실패 하면 예외를 처리 하지 않으려는 경우 호출할 수 있습니다는 DateTime.TryParse 메서드 대신 합니다.If you prefer not to handle an exception if the conversion fails, you can call the DateTime.TryParse method instead. 반환 된 Boolean 변환이 성공 또는 실패 여부를 나타내는 값입니다.It returns a Boolean value that indicates whether the conversion succeeded or failed.

추가 정보

ToDateTime(UInt16) ToDateTime(UInt16) ToDateTime(UInt16) ToDateTime(UInt16)

중요

이 API는 CLS 규격이 아닙니다.

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(System::UInt16 value);
[System.CLSCompliant(false)]
public static DateTime ToDateTime (ushort value);
static member ToDateTime : uint16 -> DateTime
Public Shared Function ToDateTime (value As UShort) As DateTime

매개 변수

value
UInt16 UInt16 UInt16 UInt16

변환할 16비트 부호 없는 정수입니다.The 16-bit unsigned integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(String, IFormatProvider) ToDateTime(String, IFormatProvider) ToDateTime(String, IFormatProvider) ToDateTime(String, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 숫자의 지정된 문자열 표현을 해당하는 날짜와 시간으로 변환합니다.Converts the specified string representation of a number to an equivalent date and time, using the specified culture-specific formatting information.

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

매개 변수

value
String String String String

변환할 날짜 및 시간이 포함된 문자열입니다.A string that contains a date and time to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 값에 해당하는 날짜와 시간이거나, MinValuevalue이면 null에 해당하는 날짜와 시간입니다.The date and time equivalent of the value of value, or the date and time equivalent of MinValue if value is null.

예외

value가 올바른 형식의 날짜 및 시간 문자열이 아닙니다.value is not a properly formatted date and time string.

예제

다음 예제에서는 날짜 값의 문자열 표현으로 변환 합니다 ToDateTime 메서드를 사용 하 여는 IFormatProvider 개체입니다.The following example converts string representations of date values with the ToDateTime method, using an IFormatProvider object.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("{0,-18}{1,-12}{2}\n", "Date String", "Culture", "Result");

      string[] cultureNames = { "en-US", "ru-RU","ja-JP" };
      string[] dateStrings = { "01/02/09", "2009/02/03",  "01/2009/03", 
                               "01/02/2009", "21/02/09", "01/22/09",  
                               "01/02/23" };
      // Iterate each culture name in the array.
      foreach (string cultureName in cultureNames)
      {
         CultureInfo culture = new CultureInfo(cultureName);
        
         // Parse each date using the designated culture.
         foreach (string dateStr in dateStrings)
         {
            DateTime dateTimeValue;
            try {
               dateTimeValue = Convert.ToDateTime(dateStr, culture);
                // Display the date and time in a fixed format.
                Console.WriteLine("{0,-18}{1,-12}{2:yyyy-MMM-dd}",
                                  dateStr, cultureName, dateTimeValue);
            }
            catch (FormatException e) { 
                Console.WriteLine("{0,-18}{1,-12}{2}", 
                                  dateStr, cultureName, e.GetType().Name);
            }
         }
         Console.WriteLine();
      }
   }
}
Imports System.Globalization

Module Example
   Public Sub Main( )
      Console.WriteLine("{0,-18}{1,-12}{2}", "Date String", "Culture", "Result")
      Console.WriteLine()

      Dim cultureNames() As String = { "en-US", "ru-RU","ja-JP" }
      Dim dateStrings() As String = { "01/02/09", "2009/02/03",  "01/2009/03", _
                                      "01/02/2009", "21/02/09", "01/22/09",   _
                                      "01/02/23" }
      ' Iterate each culture name in the array.
      For Each cultureName As String In cultureNames
         Dim culture As CultureInfo = New CultureInfo(cultureName)
        
         ' Parse each date using the designated culture.
         For Each dateStr As String In dateStrings
            Dim dateTimeValue As DateTime
            Try
               dateTimeValue = Convert.ToDateTime(dateStr, culture)
                ' Display the date and time in a fixed format.
                Console.WriteLine("{0,-18}{1,-12}{2:yyyy-MMM-dd}", _
                                  dateStr, cultureName, dateTimeValue)
            Catch e As FormatException 
                Console.WriteLine("{0,-18}{1,-12}{2}", _
                                  dateStr, cultureName, e.GetType().Name)
            End Try            
         Next
         Console.WriteLine()
      Next
   End Sub 
End Module 
' The example displays the following output:
'       Date String       Culture     Result
'       
'       01/02/09          en-US       2009-Jan-02
'       2009/02/03        en-US       2009-Feb-03
'       01/2009/03        en-US       2009-Jan-03
'       01/02/2009        en-US       2009-Jan-02
'       21/02/09          en-US       FormatException
'       01/22/09          en-US       2009-Jan-22
'       01/02/23          en-US       2023-Jan-02
'       
'       01/02/09          ru-RU       2009-Feb-01
'       2009/02/03        ru-RU       2009-Feb-03
'       01/2009/03        ru-RU       2009-Jan-03
'       01/02/2009        ru-RU       2009-Feb-01
'       21/02/09          ru-RU       2009-Feb-21
'       01/22/09          ru-RU       FormatException
'       01/02/23          ru-RU       2023-Feb-01
'       
'       01/02/09          ja-JP       2001-Feb-09
'       2009/02/03        ja-JP       2009-Feb-03
'       01/2009/03        ja-JP       2009-Jan-03
'       01/02/2009        ja-JP       2009-Jan-02
'       21/02/09          ja-JP       2021-Feb-09
'       01/22/09          ja-JP       FormatException
'       01/02/23          ja-JP       2001-Feb-23

설명

반환 값은 호출의 결과 DateTime.Parse(String, IFormatProvider) 메서드를 value입니다.The return value is the result of invoking the DateTime.Parse(String, IFormatProvider) method on value.

provider IFormatProvider 인스턴스를 가져오는 DateTimeFormatInfo 개체입니다.provider is an IFormatProvider instance that obtains a DateTimeFormatInfo object. 합니다 DateTimeFormatInfo 개체의 형식에 대 한 문화권별 형식 정보를 제공 value합니다.The DateTimeFormatInfo object provides culture-specific information about the format of value. 하는 경우 provider 됩니다 null, DateTimeFormatInfo 현재 문화권이 사용 됩니다.If provider is null, the DateTimeFormatInfo for the current culture is used.

변환에 실패 하면 예외를 처리 하지 않으려는 경우 호출할 수 있습니다는 DateTime.TryParse 메서드 대신 합니다.If you prefer not to handle an exception if the conversion fails, you can call the DateTime.TryParse method instead. 반환 된 Boolean 변환이 성공 또는 실패 여부를 나타내는 값입니다.It returns a Boolean value that indicates whether the conversion succeeded or failed.

추가 정보

ToDateTime(UInt64) ToDateTime(UInt64) ToDateTime(UInt64) ToDateTime(UInt64)

중요

이 API는 CLS 규격이 아닙니다.

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(System::UInt64 value);
[System.CLSCompliant(false)]
public static DateTime ToDateTime (ulong value);
static member ToDateTime : uint64 -> DateTime
Public Shared Function ToDateTime (value As ULong) As DateTime

매개 변수

value
UInt64 UInt64 UInt64 UInt64

변환할 64비트 부호 없는 정수입니다.The 64-bit unsigned integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Object, IFormatProvider) ToDateTime(Object, IFormatProvider) ToDateTime(Object, IFormatProvider) ToDateTime(Object, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 개체의 값을 DateTime 개체로 변환합니다.Converts the value of the specified object to a DateTime object, using the specified culture-specific formatting information.

public:
 static DateTime ToDateTime(System::Object ^ value, IFormatProvider ^ provider);
public static DateTime ToDateTime (object value, IFormatProvider provider);
static member ToDateTime : obj * IFormatProvider -> DateTime
Public Shared Function ToDateTime (value As Object, provider As IFormatProvider) As DateTime

매개 변수

value
Object Object Object Object

IConvertible 인터페이스를 구현하는 개체An object that implements the IConvertible interface.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 값에 해당하는 날짜와 시간이거나, MinValuevalue이면 null에 해당하는 날짜와 시간입니다.The date and time equivalent of the value of value, or the date and time equivalent of MinValue if value is null.

예외

value가 올바른 날짜 및 시간 값이 아닙니다.value is not a valid date and time value.

valueIConvertible 인터페이스를 구현하지 않습니다.value does not implement the IConvertible interface.

또는-or- 이 변환은 지원되지 않습니다.The conversion is not supported.

예제

다음 예제에서는 사용자 지정 형식 공급자를 정의 CustomProvider해당 GetFormat 가 호출 되 고 다음을 반환 하는 콘솔에 메시지를 출력 하는 메서드는 DateTimeFormatInfo 문화권 이름이 해당 클래스에 매개 변수로 전달 된 개체 생성자입니다.The following example defines a custom format provider, CustomProvider, whose GetFormat method outputs a message to the console that it has been invoked, and then returns the DateTimeFormatInfo object of the culture whose name was passed as a parameter to its class constructor. 이러한 각 CustomProvider 개체 개체 배열의 요소를 날짜 및 시간 값 변환에 사용 됩니다.Each of these CustomProvider objects is used to convert the elements in an object array to date and time values. 나타내는 출력을 CustomProvider 변환에서 개체를 사용 하는 경우에만 형식의 value 매개 변수는는 String.The output indicates that the CustomProvider object is used in the conversion only when the type of the value parameter is a String.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames = { "en-US", "hu-HU", "pt-PT" };
      object[] objects = { 12, 17.2, false, new DateTime(2010, 1, 1), "today", 
                           new System.Collections.ArrayList(), 'c', 
                           "05/10/2009 6:13:18 PM", "September 8, 1899" };
      
      foreach (string cultureName in cultureNames)
      {
         Console.WriteLine("{0} culture:", cultureName);
         CustomProvider provider = new CustomProvider(cultureName);
         foreach (object obj in objects)
         {            
            try {
               DateTime dateValue = Convert.ToDateTime(obj, provider);      
               Console.WriteLine("{0} --> {1}", obj, 
                                 dateValue.ToString(new CultureInfo(cultureName)));
            }
            catch (FormatException) {
               Console.WriteLine("{0} --> Bad Format", obj);
            }   
            catch (InvalidCastException) {
               Console.WriteLine("{0} --> Conversion Not Supported", obj);
            }
         }
         Console.WriteLine();
      }
   }
}

public class CustomProvider : IFormatProvider
{
   private string cultureName;
   
   public CustomProvider(string cultureName)
   {
      this.cultureName = cultureName;
   }
   
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(DateTimeFormatInfo))
      {
         Console.Write("(CustomProvider retrieved.) ");
         return new CultureInfo(cultureName).GetFormat(formatType);
      }
      else
      {
         return null;
      }   
   }
}
// The example displays the following output:
//    en-US culture:
//    12 --> Conversion Not Supported
//    17.2 --> Conversion Not Supported
//    False --> Conversion Not Supported
//    1/1/2010 12:00:00 AM --> 1/1/2010 12:00:00 AM
//    (CustomProvider retrieved.) today --> Bad Format
//    System.Collections.ArrayList --> Conversion Not Supported
//    c --> Conversion Not Supported
//    (CustomProvider retrieved.) 05/10/2009 6:13:18 PM --> 5/10/2009 6:13:18 PM
//    (CustomProvider retrieved.) September 8, 1899 --> 9/8/1899 12:00:00 AM
//    
//    hu-HU culture:
//    12 --> Conversion Not Supported
//    17.2 --> Conversion Not Supported
//    False --> Conversion Not Supported
//    1/1/2010 12:00:00 AM --> 2010. 01. 01. 0:00:00
//    (CustomProvider retrieved.) today --> Bad Format
//    System.Collections.ArrayList --> Conversion Not Supported
//    c --> Conversion Not Supported
//    (CustomProvider retrieved.) 05/10/2009 6:13:18 PM --> 2009. 05. 10. 18:13:18
//    (CustomProvider retrieved.) September 8, 1899 --> 1899. 09. 08. 0:00:00
//    
//    pt-PT culture:
//    12 --> Conversion Not Supported
//    17.2 --> Conversion Not Supported
//    False --> Conversion Not Supported
//    1/1/2010 12:00:00 AM --> 01-01-2010 0:00:00
//    (CustomProvider retrieved.) today --> Bad Format
//    System.Collections.ArrayList --> Conversion Not Supported
//    c --> Conversion Not Supported
//    (CustomProvider retrieved.) 05/10/2009 6:13:18 PM --> 05-10-2009 18:13:18
//    (CustomProvider retrieved.) September 8, 1899 --> 08-09-1899 0:00:00
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "hu-HU", "pt-PT" }
      Dim objects() As Object = { 12, 17.2, False, #1/1/2010#, "today", _
                                  New System.Collections.ArrayList(), "c"c, _
                                  "05/10/2009 6:13:18 PM", "September 8, 1899" }
      
      For Each cultureName As String In cultureNames
         Console.WriteLine("{0} culture:", cultureName)
         Dim provider As New CustomProvider(cultureName)
         For Each obj As Object In objects
            Try
               Dim dateValue As Date = Convert.ToDateTime(obj, provider)      
               Console.WriteLine("{0} --> {1}", obj, _
                                 dateValue.ToString(New CultureInfo(cultureName)))
            Catch e As FormatException
               Console.WriteLine("{0} --> Bad Format", obj)
            Catch e As InvalidCastException
               Console.WriteLine("{0} --> Conversion Not Supported", obj)
            End Try
         Next
         Console.WriteLine()
      Next
   End Sub
End Module

Public Class CustomProvider : Implements IFormatProvider
   Private cultureName As String
   
   Public Sub New(cultureName As String)
      Me.cultureName = cultureName
   End Sub
   
   Public Function GetFormat(formatType As Type) As Object _
          Implements IFormatProvider.GetFormat
      If formatType Is GetType(DateTimeFormatInfo) Then
         Console.Write("(CustomProvider retrieved.) ")
         Return New CultureInfo(cultureName).GetFormat(formatType)
      Else
         Return Nothing
      End If   
   End Function
End Class
' The example displays the following output:
'    en-US culture:
'    12 --> Conversion Not Supported
'    17.2 --> Conversion Not Supported
'    False --> Conversion Not Supported
'    1/1/2010 12:00:00 AM --> 1/1/2010 12:00:00 AM
'    (CustomProvider retrieved.) today --> Bad Format
'    System.Collections.ArrayList --> Conversion Not Supported
'    c --> Conversion Not Supported
'    (CustomProvider retrieved.) 05/10/2009 6:13:18 PM --> 5/10/2009 6:13:18 PM
'    (CustomProvider retrieved.) September 8, 1899 --> 9/8/1899 12:00:00 AM
'    
'    hu-HU culture:
'    12 --> Conversion Not Supported
'    17.2 --> Conversion Not Supported
'    False --> Conversion Not Supported
'    1/1/2010 12:00:00 AM --> 2010. 01. 01. 0:00:00
'    (CustomProvider retrieved.) today --> Bad Format
'    System.Collections.ArrayList --> Conversion Not Supported
'    c --> Conversion Not Supported
'    (CustomProvider retrieved.) 05/10/2009 6:13:18 PM --> 2009. 05. 10. 18:13:18
'    (CustomProvider retrieved.) September 8, 1899 --> 1899. 09. 08. 0:00:00
'    
'    pt-PT culture:
'    12 --> Conversion Not Supported
'    17.2 --> Conversion Not Supported
'    False --> Conversion Not Supported
'    1/1/2010 12:00:00 AM --> 01-01-2010 0:00:00
'    (CustomProvider retrieved.) today --> Bad Format
'    System.Collections.ArrayList --> Conversion Not Supported
'    c --> Conversion Not Supported
'    (CustomProvider retrieved.) 05/10/2009 6:13:18 PM --> 05-10-2009 18:13:18
'    (CustomProvider retrieved.) September 8, 1899 --> 08-09-1899 0:00:00

설명

반환 값은 호출의 결과 IConvertible.ToDateTime 기본 형식의 메서드 value합니다.The return value is the result of invoking the IConvertible.ToDateTime method of the underlying type of value.

provider 사용자의 내용에 대 한 문화권별 형식 변환 정보를 지정할 수 있게 value합니다.provider enables the user to specify culture-specific conversion information about the contents of value. 예를 들어 경우 value 되는 String 날짜를 나타내는 provider 해당 날짜를 나타내는 데 사용 되는 표기법에 대 한 문화권별 형식 정보를 제공할 수 있습니다.For example, if value is a String that represents a date, provider could supply culture-specific information about the notation used to represent that date. provider 변환에서 관련 value 런타임에서의 형식이 valueString, 이거나 value 사용자 정의 형식이 됩니다 IConvertible.ToDateTime 구현 사용 provider합니다.provider is involved in the conversion of value if the runtime type of value is a String, or if value is a user-defined type whose IConvertible.ToDateTime implementation makes use of provider. 런타임에서의 형식이 value 됩니다 Stringprovidernull, CultureInfo 현재 스레드 문화권을 나타내는 개체를 사용 합니다.If the runtime type of value is String and provider is null, the CultureInfo object that represents the current thread culture is used.

추가 정보

ToDateTime(SByte) ToDateTime(SByte) ToDateTime(SByte) ToDateTime(SByte)

중요

이 API는 CLS 규격이 아닙니다.

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(System::SByte value);
[System.CLSCompliant(false)]
public static DateTime ToDateTime (sbyte value);
static member ToDateTime : sbyte -> DateTime
Public Shared Function ToDateTime (value As SByte) As DateTime

매개 변수

value
SByte SByte SByte SByte

변환할 8비트 부호 있는 정수입니다.The 8-bit signed integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(UInt32) ToDateTime(UInt32) ToDateTime(UInt32) ToDateTime(UInt32)

중요

이 API는 CLS 규격이 아닙니다.

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(System::UInt32 value);
[System.CLSCompliant(false)]
public static DateTime ToDateTime (uint value);
static member ToDateTime : uint32 -> DateTime
Public Shared Function ToDateTime (value As UInteger) As DateTime

매개 변수

value
UInt32 UInt32 UInt32 UInt32

변환할 32비트 부호 없는 정수입니다.The 32-bit unsigned integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Object) ToDateTime(Object) ToDateTime(Object) ToDateTime(Object)

지정된 개체의 값을 DateTime 개체로 변환합니다.Converts the value of the specified object to a DateTime object.

public:
 static DateTime ToDateTime(System::Object ^ value);
public static DateTime ToDateTime (object value);
static member ToDateTime : obj -> DateTime
Public Shared Function ToDateTime (value As Object) As DateTime

매개 변수

value
Object Object Object Object

IConvertible 인터페이스를 구현하는 개체나 null입니다.An object that implements the IConvertible interface, or null.

반환

value의 값에 해당하는 날짜와 시간이거나, MinValuevalue이면 null에 해당하는 날짜와 시간입니다.The date and time equivalent of the value of value, or a date and time equivalent of MinValue if value is null.

예외

value가 올바른 날짜 및 시간 값이 아닙니다.value is not a valid date and time value.

valueIConvertible 인터페이스를 구현하지 않습니다.value does not implement the IConvertible interface.

또는-or- 이 변환은 지원되지 않습니다.The conversion is not supported.

예제

다음 예제에서는 합니다 ToDateTime(Object) 다양 한 메서드 Object 변수입니다.The following example calls the ToDateTime(Object) method with a variety of Object variables.

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.
Module ConversionToDateTime
   Public Sub Main()
      ' Try converting an integer.
      Dim number As Integer = 16352
      ConvertToDateTime(number)
      
      ' Convert a null.
      Dim obj As Object = Nothing
      ConvertToDateTime(obj)
      
      ' Convert a non-date string.
      Dim nonDateString As String = "monthly"
      ConvertToDateTime(nonDateString)
      
      ' Try to convert various dates.
      Dim dateString As String 
      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)
   End Sub
   
   Private Sub ConvertToDateTime(value As Object)
      Dim convertedDate As Date
      Try
         convertedDate = Convert.ToDateTime(value)
         Console.WriteLine("'{0}' converts to {1}.", value, convertedDate)
      Catch e As FormatException
         Console.WriteLine("'{0}' is not in the proper format.", value)
      Catch e As InvalidCastException
         Console.WriteLine("Conversion of the {0} '{1}' is not supported", _
                           value.GetType().Name, value)
      End Try
   End Sub
End Module
' 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.

설명

성공의 런타임 형식으로 변환 합니다 value 매개 변수 중 하나 여야 합니다는 DateTime 또는 String, 또는 value 여야 합니다 null.For the conversion to succeed, the runtime type of the value parameter must be either a DateTime or a String, or value must be null. 그렇지 않으면 메서드가 throw는 InvalidCastException합니다.Otherwise, the method throws an InvalidCastException. 또한 경우 value 문자열인 경우 현재 문화권의 날짜 및 시간 값의 유효한 표현이 포함 해야 합니다 또는 FormatException throw 됩니다.In addition, if value is a string, it must contain a valid representation of a date and time value in the current culture or a FormatException is thrown.

반환 값은 호출의 결과 IConvertible.ToDateTime 기본 형식의 메서드 value합니다.The return value is the result of invoking the IConvertible.ToDateTime method of the underlying type of value.

ToDateTime(Double) ToDateTime(Double) ToDateTime(Double) ToDateTime(Double)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(double value);
public static DateTime ToDateTime (double value);
static member ToDateTime : double -> DateTime
Public Shared Function ToDateTime (value As Double) As DateTime

매개 변수

value
Double Double Double Double

변환할 배정밀도 부동 소수점 값입니다.The double-precision floating-point value to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Int32) ToDateTime(Int32) ToDateTime(Int32) ToDateTime(Int32)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(int value);
public static DateTime ToDateTime (int value);
static member ToDateTime : int -> DateTime
Public Shared Function ToDateTime (value As Integer) As DateTime

매개 변수

value
Int32 Int32 Int32 Int32

변환할 32비트 부호 있는 정수입니다.The 32-bit signed integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Boolean) ToDateTime(Boolean) ToDateTime(Boolean) ToDateTime(Boolean)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(bool value);
public static DateTime ToDateTime (bool value);
static member ToDateTime : bool -> DateTime
Public Shared Function ToDateTime (value As Boolean) As DateTime

매개 변수

value
Boolean Boolean Boolean Boolean

변환할 부울 값입니다.The Boolean value to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Byte) ToDateTime(Byte) ToDateTime(Byte) ToDateTime(Byte)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(System::Byte value);
public static DateTime ToDateTime (byte value);
static member ToDateTime : byte -> DateTime
Public Shared Function ToDateTime (value As Byte) As DateTime

매개 변수

value
Byte Byte Byte Byte

변환할 8비트 부호 없는 정수입니다.The 8-bit unsigned integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Char) ToDateTime(Char) ToDateTime(Char) ToDateTime(Char)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(char value);
public static DateTime ToDateTime (char value);
static member ToDateTime : char -> DateTime
Public Shared Function ToDateTime (value As Char) As DateTime

매개 변수

value
Char Char Char Char

변환할 유니코드 문자입니다.The Unicode character to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Int64) ToDateTime(Int64) ToDateTime(Int64) ToDateTime(Int64)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(long value);
public static DateTime ToDateTime (long value);
static member ToDateTime : int64 -> DateTime
Public Shared Function ToDateTime (value As Long) As DateTime

매개 변수

value
Int64 Int64 Int64 Int64

변환할 64비트 부호 있는 정수입니다.The 64-bit signed integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(Decimal) ToDateTime(Decimal) ToDateTime(Decimal) ToDateTime(Decimal)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(System::Decimal value);
public static DateTime ToDateTime (decimal value);
static member ToDateTime : decimal -> DateTime
Public Shared Function ToDateTime (value As Decimal) As DateTime

매개 변수

value
Decimal Decimal Decimal Decimal

변환할 숫자입니다.The number to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

ToDateTime(Int16) ToDateTime(Int16) ToDateTime(Int16) ToDateTime(Int16)

이 메서드를 호출하면 InvalidCastException이 항상 throw됩니다.Calling this method always throws InvalidCastException.

public:
 static DateTime ToDateTime(short value);
public static DateTime ToDateTime (short value);
static member ToDateTime : int16 -> DateTime
Public Shared Function ToDateTime (value As Short) As DateTime

매개 변수

value
Int16 Int16 Int16 Int16

변환할 16비트 부호 있는 정수입니다.The 16-bit signed integer to convert.

반환

이 변환은 지원되지 않습니다.This conversion is not supported. 값이 반환되지 않습니다.No value is returned.

예외

이 변환은 지원되지 않습니다.This conversion is not supported.

추가 정보

ToDateTime(DateTime) ToDateTime(DateTime) ToDateTime(DateTime) ToDateTime(DateTime)

지정된 DateTime 개체를 실제 변환 작업 없이 반환합니다.Returns the specified DateTime object; no actual conversion is performed.

public:
 static DateTime ToDateTime(DateTime value);
public static DateTime ToDateTime (DateTime value);
static member ToDateTime : DateTime -> DateTime
Public Shared Function ToDateTime (value As DateTime) As DateTime

매개 변수

value
DateTime DateTime DateTime DateTime

날짜 및 시간 값입니다.A date and time value.

반환

value를 변경하지 않고 반환합니다.value is returned unchanged.

적용 대상