Convert.ToDateTime Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Converte un valore specificato in un valore DateTime.

Overload

ToDateTime(Single)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(String)	Converte la rappresentazione di stringa specificata di una data e un'ora in un valore di data e ora equivalente.
ToDateTime(UInt16)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(String, IFormatProvider)	Converte la rappresentazione di stringa specificata di un numero in un valore di data e ora equivalente mediante le informazioni di formattazione specifiche delle impostazioni cultura indicate.
ToDateTime(UInt64)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Object, IFormatProvider)	Converte il valore dell'oggetto specificato in un oggetto DateTime mediante le informazioni di formattazione specifiche delle impostazioni cultura indicate.
ToDateTime(SByte)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(UInt32)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Object)	Converte il valore dell'oggetto specificato in un oggetto DateTime.
ToDateTime(Int16)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Int32)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Int64)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Double)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Decimal)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(DateTime)	Restituisce l'oggetto DateTime specificato; di fatto, non viene eseguita alcuna conversione.
ToDateTime(Char)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Byte)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.
ToDateTime(Boolean)	La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

ToDateTime(Single)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (float value);

Parametri

value

Single

Valore a virgola mobile a precisione singola da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Single

ToDateTime(String)

Origine:

Convert.cs

Converte la rappresentazione di stringa specificata di una data e un'ora in un valore di data e ora equivalente.

C#

public static DateTime ToDateTime (string? value);

Parametri

value

String

Rappresentazione di stringa di una data e ora.

Restituisce

DateTime

Equivalente di data e ora del valore di valueoppure l'equivalente di data e ora di DateTime.MinValue se value è null.

Eccezioni

FormatException

value non è una stringa di data e ora formattata correttamente.

Esempio

Nell'esempio seguente viene utilizzato il ToDateTime metodo per convertire varie rappresentazioni di stringa di date e ore in DateTime valori .

C#

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.

Commenti

Se value non nullè , il valore restituito è il risultato di richiamare il DateTime.Parse metodo su value utilizzando le informazioni di formattazione in un DateTimeFormatInfo oggetto inizializzato per le impostazioni cultura correnti. L'argomento value deve contenere la rappresentazione di una data e di un'ora in uno dei formati descritti nell'argomento DateTimeFormatInfo . Se value è null, il metodo restituisce DateTime.MinValue.

Questo metodo tenta di analizzare completamente value ed evitare di generare un'eccezione FormatException. Completa le informazioni relative a mese, giorno e anno mancanti con la data corrente. Se value contiene solo una data e nessuna ora, questo metodo presuppone un'ora di mezzanotte. Tutti gli spazi vuoti iniziali, interni o finali in value vengono ignorati.

Se si preferisce non gestire un'eccezione se la conversione non riesce, è invece possibile chiamare il DateTime.TryParse metodo . Restituisce un Boolean valore che indica se la conversione ha avuto esito positivo o negativo.

Vedi anche

• CurrentCulture
• Analisi di stringhe di data e ora in .NET

ToDateTime(UInt16)

Origine:

Convert.cs

Importante

Questa API non è conforme a CLS.

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

[System.CLSCompliant(false)]
public static DateTime ToDateTime (ushort value);

Parametri

value

UInt16

Intero senza segno a 16 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Attributi

CLSCompliantAttribute

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• UInt16

ToDateTime(String, IFormatProvider)

Origine:

Convert.cs

Converte la rappresentazione di stringa specificata di un numero in un valore di data e ora equivalente mediante le informazioni di formattazione specifiche delle impostazioni cultura indicate.

C#

public static DateTime ToDateTime (string? value, IFormatProvider? provider);

Parametri

value

String

Stringa che contiene una data e un'ora da convertire.

provider

IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

Restituisce

DateTime

Equivalente di data e ora del valore di valueoppure l'equivalente di data e ora di DateTime.MinValue se value è null.

Eccezioni

FormatException

value non è una stringa di data e ora formattata correttamente.

Esempio

Nell'esempio seguente le rappresentazioni di stringa dei valori di data con il ToDateTime metodo utilizzano un IFormatProvider oggetto .

C#

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();
      }
   }
}

Commenti

Il valore restituito è il risultato di richiamare il DateTime.Parse(String, IFormatProvider) metodo su value.

provider è un'istanza IFormatProvider che ottiene un DateTimeFormatInfo oggetto . L'oggetto DateTimeFormatInfo fornisce informazioni specifiche delle impostazioni cultura sul formato di value. Se provider è null, viene utilizzato per DateTimeFormatInfo le impostazioni cultura correnti.

Se si preferisce non gestire un'eccezione se la conversione non riesce, è invece possibile chiamare il DateTime.TryParse metodo . Restituisce un Boolean valore che indica se la conversione ha avuto esito positivo o negativo.

Vedi anche

• Analisi di stringhe di data e ora in .NET

ToDateTime(UInt64)

Origine:

Convert.cs

Importante

Questa API non è conforme a CLS.

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

[System.CLSCompliant(false)]
public static DateTime ToDateTime (ulong value);

Parametri

value

UInt64

Intero senza segno a 64 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Attributi

CLSCompliantAttribute

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• UInt64

ToDateTime(Object, IFormatProvider)

Origine:

Convert.cs

Converte il valore dell'oggetto specificato in un oggetto DateTime mediante le informazioni di formattazione specifiche delle impostazioni cultura indicate.

C#

public static DateTime ToDateTime (object? value, IFormatProvider? provider);

Parametri

value

Object

Oggetto che implementa l'interfaccia IConvertible.

provider

IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

Restituisce

DateTime

Equivalente di data e ora del valore di valueoppure l'equivalente di data e ora di DateTime.MinValue se value è null.

Eccezioni

FormatException

Valore di data e ora value non valido.

InvalidCastException

value non implementa l'interfaccia IConvertible.

-oppure-

La conversione non è supportata.

Esempio

Nell'esempio seguente viene definito un provider di formato personalizzato, CustomProvider, il cui metodo restituisce un messaggio alla console richiamata e quindi restituisce l'oggetto DateTimeFormatInfo delle impostazioni cultura il cui GetFormat nome è stato passato come parametro al relativo costruttore di classe. Ognuno di questi CustomProvider oggetti viene usato per convertire gli elementi in una matrice di oggetti in valori di data e ora. L'output indica che l'oggetto CustomProvider viene utilizzato nella conversione solo quando il tipo del value parametro è .String

C#

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

Commenti

Il valore restituito è il risultato di richiamare il IConvertible.ToDateTime metodo del tipo sottostante di value.

provider consente all'utente di specificare informazioni di conversione specifiche delle impostazioni cultura sul contenuto di value. Ad esempio, se value è un String oggetto che rappresenta una data, provider potrebbe fornire informazioni specifiche delle impostazioni cultura sulla notazione utilizzata per rappresentare tale data. provider è coinvolto nella conversione di value se il tipo di runtime di value è o Stringse value è un tipo definito dall'utente la cui IConvertible.ToDateTime implementazione usa provider. Se il tipo di runtime di value è String e provider è null, viene utilizzato l'oggetto CultureInfo che rappresenta le impostazioni cultura correnti.

Vedi anche

• Analisi di stringhe di data e ora in .NET

ToDateTime(SByte)

Origine:

Convert.cs

Importante

Questa API non è conforme a CLS.

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

[System.CLSCompliant(false)]
public static DateTime ToDateTime (sbyte value);

Parametri

value

SByte

Intero con segno a 8 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Attributi

CLSCompliantAttribute

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Byte

ToDateTime(UInt32)

Origine:

Convert.cs

Importante

Questa API non è conforme a CLS.

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

[System.CLSCompliant(false)]
public static DateTime ToDateTime (uint value);

Parametri

value

UInt32

Intero senza segno a 32 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Attributi

CLSCompliantAttribute

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• UInt32

ToDateTime(Object)

Origine:

Convert.cs

Converte il valore dell'oggetto specificato in un oggetto DateTime.

C#

public static DateTime ToDateTime (object? value);

Parametri

value

Object

Oggetto che implementa l'interfaccia IConvertible oppure null.

Restituisce

DateTime

Equivalente di data e ora del valore di valueoppure un equivalente di data e ora di DateTime.MinValue se value è null.

Eccezioni

FormatException

Valore di data e ora value non valido.

InvalidCastException

value non implementa l'interfaccia IConvertible.

-oppure-

La conversione non è supportata.

Esempio

Nell'esempio seguente viene chiamato il ToDateTime(Object) metodo con un'ampia gamma di Object variabili.

C#

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.

Commenti

Affinché la conversione abbia esito positivo, il tipo di runtime del value parametro deve essere o DateTimeStringvalue oppure deve essere null. In caso contrario, il metodo genera un'eccezione InvalidCastException. Inoltre, se value è una stringa, deve contenere una rappresentazione valida di un valore di data e ora nelle impostazioni cultura correnti oppure viene generata un'eccezione FormatException .

Il valore restituito è il risultato di richiamare il IConvertible.ToDateTime metodo del tipo sottostante di value.

ToDateTime(Int16)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (short value);

Parametri

value

Int16

Intero con segno a 16 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Int16

ToDateTime(Int32)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (int value);

Parametri

value

Int32

Intero con segno a 32 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Int32

ToDateTime(Int64)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (long value);

Parametri

value

Int64

Intero con segno a 64 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Int64

ToDateTime(Double)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (double value);

Parametri

value

Double

Valore a virgola mobile e con precisione doppia da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Double

ToDateTime(Decimal)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (decimal value);

Parametri

value

Decimal

Numero da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

ToDateTime(DateTime)

Origine:

Convert.cs

Restituisce l'oggetto DateTime specificato; di fatto, non viene eseguita alcuna conversione.

C#

public static DateTime ToDateTime (DateTime value);

Parametri

value

DateTime

Valore di data e ora.

Restituisce

DateTime

value viene restituito invariato.

ToDateTime(Char)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (char value);

Parametri

value

Char

Carattere Unicode da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Char

ToDateTime(Byte)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (byte value);

Parametri

value

Byte

Intero senza segno a 8 bit da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Byte

ToDateTime(Boolean)

Origine:

Convert.cs

La chiamata di questo metodo genera sempre un'eccezione InvalidCastException.

C#

public static DateTime ToDateTime (bool value);

Parametri

value

Boolean

Valore booleano da convertire.

Restituisce

DateTime

Questa conversione non è supportata. Non vengono restituiti valori.

Eccezioni

InvalidCastException

Questa conversione non è supportata.

Vedi anche

• Boolean