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

Definition

Konvertiert einen angegebenen Wert in einen DateTime-Wert.Converts a specified value to a DateTime value.

Überlädt

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in einen entsprechenden Datums- und Uhrzeitwert.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)

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Konvertiert die angegebene Zeichenfolgendarstellung einer Zahl unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in ein entsprechendes Datum und eine entsprechende Uhrzeit.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)

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in ein DateTime-Objekt.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)

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Konvertiert den Wert des angegebenen Objekts in ein DateTime-Objekt.Converts the value of the specified object to a DateTime object.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.Calling this method always throws InvalidCastException.

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

Gibt das angegebene DateTime Objekt zurück. Es wird keine wirkliche Konvertierung durchgeführt.Returns the specified DateTime object; no actual conversion is performed.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Single Single Single Single

Der zu konvertierende Gleitkommawert mit einfacher Genauigkeit.The single-precision floating-point value to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in einen entsprechenden Datums- und Uhrzeitwert.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

Parameter

value
String String String String

Die Zeichenfolgendarstellung eines Datums- und Uhrzeitwerts.The string representation of a date and time.

Gibt zurück

Die Datums- und Uhrzeitentsprechung des Werts von value oder die Datums- und Uhrzeitentsprechung von MinValue, wenn value gleich null ist.The date and time equivalent of the value of value, or the date and time equivalent of MinValue if value is null.

Ausnahmen

value ist keine ordnungsgemäß formatierte Datums- und Zeitzeichenfolge.value is not a properly formatted date and time string.

Beispiele

Im folgenden Beispiel wird die ToDateTime -Methode zum Konvertieren verschiedener Zeichen folgen Darstellungen von Datums- DateTime und Uhrzeitwerten in-Werte verwendet.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.

Hinweise

Wenn value DateTime.Parse nicht nullist, ist der Rückgabewert das Ergebnis des Aufrufs der- value Methode für die Verwendung der Formatierungsinformationen in einem DateTimeFormatInfo -Objekt, das für die aktuelle Kultur initialisiert wird.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. Das value -Argument muss die Darstellung eines Datums und einer Uhrzeit in einem der Formate enthalten, die DateTimeFormatInfo im Thema beschrieben werden.The value argument must contain the representation of a date and time in one of the formats described in the DateTimeFormatInfo topic. Wenn value gleich null ist, gibt die Methode DateTime.MinValue zurück.If value is null, the method returns DateTime.MinValue.

Diese Methode versucht, value vollständig zu analysieren und zu vermeiden, dass eine FormatExceptionausgelöst wird.This method tries to parse value completely and avoid throwing a FormatException. Es werden fehlende Monats-, Tages-und Jahres Informationen mit dem aktuellen Datum abgeschlossen.It completes missing month, day, and year information with the current date. Wenn value nur ein Datum und keine Uhrzeit enthält, nimmt diese Methode eine Uhrzeit von Mitternacht an.If value contains only a date and no time, this method assumes a time of midnight. Alle führenden, inneren oder nachfolgenden Leerzeichen in value werden ignoriert.Any leading, inner, or trailing white-space characters in value are ignored.

Wenn eine Ausnahme nicht behandelt werden soll, wenn bei der Konvertierung ein Fehler auftritt, können DateTime.TryParse Sie stattdessen die-Methode aufzurufen.If you prefer not to handle an exception if the conversion fails, you can call the DateTime.TryParse method instead. Gibt einen Boolean Wert zurück, der angibt, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.It returns a Boolean value that indicates whether the conversion succeeded or failed.

Siehe auch

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
UInt16 UInt16 UInt16 UInt16

Die zu konvertierende 16-Bit-Ganzzahl ohne Vorzeichen.The 16-bit unsigned integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Konvertiert die angegebene Zeichenfolgendarstellung einer Zahl unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in ein entsprechendes Datum und eine entsprechende Uhrzeit.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

Parameter

value
String String String String

Eine Zeichenfolge, die eine zu konvertierende Datums- und Zeitangabe enthält.A string that contains a date and time to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Datums- und Uhrzeitentsprechung des Werts von value oder die Datums- und Uhrzeitentsprechung von MinValue, wenn value gleich null ist.The date and time equivalent of the value of value, or the date and time equivalent of MinValue if value is null.

Ausnahmen

value ist keine ordnungsgemäß formatierte Datums- und Zeitzeichenfolge.value is not a properly formatted date and time string.

Beispiele

Im folgenden Beispiel werden Zeichen folgen Darstellungen von Datums Werten mit ToDateTime der-Methode konvertiert IFormatProvider , wobei ein-Objekt verwendet wird.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

Hinweise

Der Rückgabewert ist das Ergebnis des Aufrufs DateTime.Parse(String, IFormatProvider) der- valueMethode für.The return value is the result of invoking the DateTime.Parse(String, IFormatProvider) method on value.

providerist eine IFormatProvider -Instanz, die DateTimeFormatInfo ein-Objekt abruft.provider is an IFormatProvider instance that obtains a DateTimeFormatInfo object. Das DateTimeFormatInfo -Objekt stellt kulturspezifische Informationen zum Format von valuebereit.The DateTimeFormatInfo object provides culture-specific information about the format of value. Wenn provider DateTimeFormatInfo ist null, wird der für die aktuelle Kultur verwendet.If provider is null, the DateTimeFormatInfo for the current culture is used.

Wenn eine Ausnahme nicht behandelt werden soll, wenn bei der Konvertierung ein Fehler auftritt, können DateTime.TryParse Sie stattdessen die-Methode aufzurufen.If you prefer not to handle an exception if the conversion fails, you can call the DateTime.TryParse method instead. Gibt einen Boolean Wert zurück, der angibt, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.It returns a Boolean value that indicates whether the conversion succeeded or failed.

Siehe auch

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
UInt64 UInt64 UInt64 UInt64

Die zu konvertierende 64-Bit-Ganzzahl ohne Vorzeichen.The 64-bit unsigned integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in ein DateTime-Objekt.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

Parameter

value
Object Object Object Object

Ein Objekt, das die IConvertible-Schnittstelle implementiert.An object that implements the IConvertible interface.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Datums- und Uhrzeitentsprechung des Werts von value oder die Datums- und Uhrzeitentsprechung von MinValue, wenn value gleich null ist.The date and time equivalent of the value of value, or the date and time equivalent of MinValue if value is null.

Ausnahmen

value ist kein gültiger Datums- und Uhrzeitwert.value is not a valid date and time value.

Die IConvertible-Schnittstelle wird von value nicht implementiert.value does not implement the IConvertible interface.

- oder --or- Die Konvertierung wird nicht unterstützt.The conversion is not supported.

Beispiele

Im folgenden Beispiel wird ein benutzerdefinierter Format Anbieter CustomProviderdefiniert, GetFormat , dessen Methode eine Meldung an die aufgerufene Konsole ausgibt und dann das DateTimeFormatInfo Objekt der Kultur zurückgibt, deren Name als Parameter an seine Klasse übergeben wurde. Konstruktor.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. Jedes dieser CustomProvider Objekte wird verwendet, um die Elemente in einem Objekt Array in Datums-und Uhrzeitwerte zu konvertieren.Each of these CustomProvider objects is used to convert the elements in an object array to date and time values. Die Ausgabe gibt an, CustomProvider dass das Objekt nur in der Konvertierung verwendet wird, wenn der value Typ des para Stringmeters ein ist.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

Hinweise

Der Rückgabewert ist das Ergebnis des Aufrufs IConvertible.ToDateTime der-Methode des zugrunde liegenden valueTyps von.The return value is the result of invoking the IConvertible.ToDateTime method of the underlying type of value.

providerermöglicht es dem Benutzer, kulturspezifische Konvertierungs Informationen zum Inhalt von valueanzugeben.provider enables the user to specify culture-specific conversion information about the contents of value. Wenn value z. b. ein String ist, das ein Datum provider darstellt, kann kulturspezifische Informationen über die Notation bereitstellen, die für dieses Datum verwendet wird.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. providerist value an der Konvertierung von beteiligt, wenn der Lauf Zeittyp von value ein Stringist value , oder wenn ein benutzerdefinierter Typ IConvertible.ToDateTime providerist, dessen-Implementierung verwendet.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. Wenn der Lauf Zeittyp String von provider value ist nullund den CultureInfo Wert hat, wird das-Objekt verwendet, das die aktuelle Thread Kultur darstellt.If the runtime type of value is String and provider is null, the CultureInfo object that represents the current thread culture is used.

Siehe auch

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
SByte SByte SByte SByte

Die zu konvertierende 8-Bit-Ganzzahl mit Vorzeichen.The 8-bit signed integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
UInt32 UInt32 UInt32 UInt32

Die zu konvertierende 32-Bit-Ganzzahl ohne Vorzeichen.The 32-bit unsigned integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Konvertiert den Wert des angegebenen Objekts in ein DateTime-Objekt.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

Parameter

value
Object Object Object Object

Ein Objekt, das die IConvertible-Schnittstelle implementiert, oder null.An object that implements the IConvertible interface, or null.

Gibt zurück

Die Datums- und Uhrzeitentsprechung des Werts von value oder eine Datums- und Uhrzeitentsprechung von MinValue, wenn value gleich null ist.The date and time equivalent of the value of value, or a date and time equivalent of MinValue if value is null.

Ausnahmen

value ist kein gültiger Datums- und Uhrzeitwert.value is not a valid date and time value.

Die IConvertible-Schnittstelle wird von value nicht implementiert.value does not implement the IConvertible interface.

- oder --or- Die Konvertierung wird nicht unterstützt.The conversion is not supported.

Beispiele

Im folgenden Beispiel wird die ToDateTime(Object) -Methode mit einer Vielzahl Object von Variablen aufgerufen.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.

Hinweise

Damit die Konvertierung erfolgreich ist, muss der Lauf Zeittyp des value -Parameters entweder ein String DateTime oder ein sein, nulloder value muss sein.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. Andernfalls löst die Methode eine InvalidCastExceptionaus.Otherwise, the method throws an InvalidCastException. Wenn value darüber hinaus eine Zeichenfolge ist, muss Sie eine gültige Darstellung eines Datums-und Uhrzeitwerts in der aktuellen Kultur enthalten, FormatException oder eine wird ausgelöst.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.

Der Rückgabewert ist das Ergebnis des Aufrufs IConvertible.ToDateTime der-Methode des zugrunde liegenden valueTyps von.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)

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Double Double Double Double

Der zu konvertierende Gleitkommawert mit doppelter Genauigkeit.The double-precision floating-point value to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Int32 Int32 Int32 Int32

Die zu konvertierende 32-Bit-Ganzzahl mit Vorzeichen.The 32-bit signed integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Boolean Boolean Boolean Boolean

Der zu konvertierende boolesche Wert.The Boolean value to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Byte Byte Byte Byte

Die zu konvertierende 8-Bit-Ganzzahl ohne Vorzeichen.The 8-bit unsigned integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Char Char Char Char

Das zu konvertierende Unicode-Zeichen.The Unicode character to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Int64 Int64 Int64 Int64

Die zu konvertierende 64-Bit-Ganzzahl mit Vorzeichen.The 64-bit signed integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Decimal Decimal Decimal Decimal

Die zu konvertierende Zahl.The number to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

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

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.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

Parameter

value
Int16 Int16 Int16 Int16

Die zu konvertierende 16-Bit-Ganzzahl mit Vorzeichen.The 16-bit signed integer to convert.

Gibt zurück

Diese Konvertierung wird nicht unterstützt.This conversion is not supported. Es wird kein Wert zurückgegeben.No value is returned.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.This conversion is not supported.

Siehe auch

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

Gibt das angegebene DateTime Objekt zurück. Es wird keine wirkliche Konvertierung durchgeführt.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

Parameter

value
DateTime DateTime DateTime DateTime

Ein Datums- und Uhrzeitwert.A date and time value.

Gibt zurück

value wird unverändert zurückgegeben.value is returned unchanged.

Gilt für: