Convert.ToDateTime Método

Definição

Espaço de Nomes:: System

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Assemblagens:: mscorlib.dll, System.Runtime.Extensions.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Converte um valor especificado num DateTime valor.

Sobrecargas

Name	Description
ToDateTime(Single)	Chamar este método gera sempre .InvalidCastException
ToDateTime(String)	Converte a representação especificada de uma data e hora para um valor equivalente de data e hora.
ToDateTime(UInt16)	Chamar este método gera sempre .InvalidCastException
ToDateTime(String, IFormatProvider)	Converte a representação em cadeia especificada de um número para uma data e hora equivalentes, usando a informação de formatação específica da cultura especificada.
ToDateTime(UInt64)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Object, IFormatProvider)	Converte o valor do objeto especificado para um DateTime objeto, usando a informação de formatação específica da cultura.
ToDateTime(SByte)	Chamar este método gera sempre .InvalidCastException
ToDateTime(UInt32)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Object)	Converte o valor do objeto especificado num DateTime objeto.
ToDateTime(Double)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Int32)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Int16)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Int64)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Decimal)	Chamar este método gera sempre .InvalidCastException
ToDateTime(DateTime)	Devolve o objeto especificado DateTime ; não é realizada nenhuma conversão real.
ToDateTime(Char)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Byte)	Chamar este método gera sempre .InvalidCastException
ToDateTime(Boolean)	Chamar este método gera sempre .InvalidCastException

ToDateTime(Single)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Single

O valor de ponto flutuante de precisão simples a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Single

Aplica-se a

ToDateTime(String)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Converte a representação especificada de uma data e hora para um valor equivalente de data e hora.

public:
 static DateTime ToDateTime(System::String ^ value);

public static DateTime ToDateTime(string value);

public static DateTime ToDateTime(string? value);

static member ToDateTime : string -> DateTime

Public Shared Function ToDateTime (value As String) As DateTime

Parâmetros

value: String

A representação em cadeia de uma data e hora.

Devoluções

DateTime

O equivalente data e hora do valor de value, ou o equivalente data e hora de DateTime.MinValue se value for null.

Exceções

FormatException

value não é uma sequência de data e hora devidamente formatadas.

Exemplos

O exemplo seguinte utiliza o ToDateTime método para converter várias representações de cadeias de datas e horas em DateTime valores.

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.

open System

let convertToDateTime (value: string) =
    try
        let convertedDate = Convert.ToDateTime value
        printfn $"'{value}' converts to {convertedDate} {convertedDate.Kind} time."
    with :?FormatException ->
        printfn $"'{value}' is not in the proper format."

[<EntryPoint>]
let main _ =
    let dateString = null

    // Convert a null string.
    convertToDateTime dateString

    // Convert an empty string.
    let dateString = String.Empty
    convertToDateTime dateString

    // Convert a non-date string.
    let dateString = "not a date"
    convertToDateTime dateString

    // Try to convert various date strings.
    let dateString = "05/01/1996"
    convertToDateTime dateString
    let dateString = "Tue Apr 28, 2009"
    convertToDateTime dateString
    let dateString = "Wed Apr 28, 2009"
    convertToDateTime dateString
    let dateString = "06 July 2008 7:32:47 AM"
    convertToDateTime dateString
    let dateString = "17:32:47.003"
    convertToDateTime dateString
    // Convert a string returned by DateTime.ToString("R").
    let dateString = "Sat, 10 May 2008 14:32:17 GMT"
    convertToDateTime dateString
    // Convert a string returned by DateTime.ToString("o").
    let dateString = "2009-05-01T07:54:59.9843750-04:00"
    convertToDateTime dateString

    0

// 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.

Observações

Se value não for , o valor de retorno é o resultado da invocação do null método ao DateTime.Parse usar a informação de formatação num value objeto que está inicializado para a cultura DateTimeFormatInfoatual. O value argumento deve conter a representação de uma data e hora num dos formatos descritos no DateTimeFormatInfo tema. Se value for null, o método devolve DateTime.MinValue.

Este método tenta analisar value completamente e evitar lançar um FormatException. Completa a informação de mês, dia e ano em falta com a data atual. Se value contiver apenas uma data e nenhuma hora, este método assume uma hora da meia-noite. Quaisquer caracteres value de espaço em branco iniciais, internos ou posteriores são ignorados.

Se preferir não tratar uma exceção caso a conversão falhe, pode chamar o DateTime.TryParse método em vez disso. Devolve um Boolean valor que indica se a conversão teve sucesso ou falhou.

Ver também

Aplica-se a

ToDateTime(UInt16)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Importante

Esta API não está em conformidade com CLS.

Chamar este método gera sempre .InvalidCastException

public:
 static DateTime ToDateTime(System::UInt16 value);

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

[<System.CLSCompliant(false)>]
static member ToDateTime : uint16 -> DateTime

Public Shared Function ToDateTime (value As UShort) As DateTime

Parâmetros

value: UInt16

O inteiro não assinado de 16 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Atributos: CLSCompliantAttribute

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

UInt16

Aplica-se a

ToDateTime(String, IFormatProvider)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Converte a representação em cadeia especificada de um número para uma data e hora equivalentes, usando a informação de formatação específica da cultura especificada.

public:
 static DateTime ToDateTime(System::String ^ value, IFormatProvider ^ provider);

public static DateTime ToDateTime(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

Parâmetros

value: String

Uma cadeia que contém uma data e hora para converter.

provider: IFormatProvider

Um objeto que fornece informação de formatação específica para cada cultura.

Devoluções

DateTime

O equivalente data e hora do valor de value, ou o equivalente data e hora de DateTime.MinValue se value for null.

Exceções

FormatException

value não é uma sequência de data e hora devidamente formatadas.

Exemplos

O exemplo seguinte converte representações de cadeias de valores de data com o ToDateTime método, usando um IFormatProvider objeto.

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

open System
open System.Globalization

printfn $"""{"Date String",-18}{"Culture",-12}{"Result"}\n"""

let cultureNames = [ "en-US"; "ru-RU"; "ja-JP" ]
let 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.
for cultureName in cultureNames do
    let culture = CultureInfo cultureName

    // Parse each date using the designated culture.
    for dateStr in dateStrings do
        try
            let dateTimeValue = Convert.ToDateTime(dateStr, culture)
            // Display the date and time in a fixed format.
            printfn $"""{dateStr,-18}{cultureName,-12}{dateTimeValue.ToString "yyyy-MMM-dd"}"""
        with :? FormatException as e ->
            printfn $"{dateStr,-18}{cultureName,-12}{e.GetType().Name}"
    printfn ""

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

Observações

O valor de retorno é o resultado da invocação do DateTime.Parse(String, IFormatProvider) método em value.

provider é uma IFormatProvider instância que obtém um DateTimeFormatInfo objeto. O DateTimeFormatInfo objeto fornece informação específica da cultura sobre o formato de value. Se provider for null, o DateTimeFormatInfo para a cultura atual é usado.

Se preferir não tratar uma exceção caso a conversão falhe, pode chamar o DateTime.TryParse método em vez disso. Devolve um Boolean valor que indica se a conversão teve sucesso ou falhou.

Ver também

Análise de Sequências de Data e Hora em .NET

Aplica-se a

ToDateTime(UInt64)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Importante

Esta API não está em conformidade com CLS.

Chamar este método gera sempre .InvalidCastException

public:
 static DateTime ToDateTime(System::UInt64 value);

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

[<System.CLSCompliant(false)>]
static member ToDateTime : uint64 -> DateTime

Public Shared Function ToDateTime (value As ULong) As DateTime

Parâmetros

value: UInt64

O inteiro não assinado de 64 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Atributos: CLSCompliantAttribute

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

UInt64

Aplica-se a

ToDateTime(Object, IFormatProvider)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Converte o valor do objeto especificado para um DateTime objeto, usando a informação de formatação específica da cultura.

public:
 static DateTime ToDateTime(System::Object ^ value, IFormatProvider ^ provider);

public static DateTime ToDateTime(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

Parâmetros

value: Object

Um objeto que implementa a IConvertible interface.

provider: IFormatProvider

Um objeto que fornece informação de formatação específica para cada cultura.

Devoluções

DateTime

O equivalente data e hora do valor de value, ou o equivalente data e hora de DateTime.MinValue se value for null.

Exceções

FormatException

value não é um valor válido de data e hora.

InvalidCastException

value não implementa a IConvertible interface.

-ou-

A conversão não é suportada.

Exemplos

O exemplo seguinte define um fornecedor de formato personalizado, CustomProvider, cujo GetFormat método envia uma mensagem para a consola a indicar que foi invocado, e depois devolve o DateTimeFormatInfo objeto da cultura cujo nome foi passado como parâmetro ao seu construtor de classe. Cada um destes CustomProvider objetos é usado para converter os elementos de um array de objetos para valores de data e hora. A saída indica que o CustomProvider objeto é usado na conversão apenas quando o tipo do value parâmetro é um 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

open System
open System.Globalization

type CustomProvider(cultureName: string) =
    interface IFormatProvider with
        member _.GetFormat(formatType) =
            if formatType = typeof<DateTimeFormatInfo> then
                printf "(CustomProvider retrieved.) "
                CultureInfo(cultureName).GetFormat formatType
            else
                null

let cultureNames = [ "en-US"; "hu-HU"; "pt-PT" ]
let objects: obj list =
    [ 12; 17.2; false; DateTime(2010, 1, 1); "today"
      System.Collections.ArrayList(); 'c'
      "05/10/2009 6:13:18 PM"; "September 8, 1899" ]

for cultureName in cultureNames do
    printfn $"{cultureName} culture:"
    let provider = CustomProvider cultureName
    for obj in objects do
        try
            let dateValue = Convert.ToDateTime(obj, provider)
            printfn $"{obj} --> {dateValue.ToString(CultureInfo cultureName)}"
        with
        | :? FormatException ->
            printfn $"{obj} --> Bad Format"
        | :? InvalidCastException ->
            printfn $"{obj} --> Conversion Not Supported"
    printfn ""

// 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

Observações

O valor de retorno é o resultado da invocação do IConvertible.ToDateTime método do tipo subjacente de value.

provider permite ao utilizador especificar informações de conversão específicas da cultura sobre o conteúdo de value. Por exemplo, se value for a String que representa uma data, provider pode fornecer informação específica da cultura sobre a notação usada para representar essa data. provider está envolvida na conversão de value se o tipo de tempo de execução de value for um String, ou se value for um tipo definido pelo utilizador cuja IConvertible.ToDateTime implementação utiliza provider. Se o tipo de runtime de value for String e provider for null, o CultureInfo objeto que representa a cultura atual é usado.

Ver também

Análise de Sequências de Data e Hora em .NET

Aplica-se a

ToDateTime(SByte)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Importante

Esta API não está em conformidade com CLS.

Chamar este método gera sempre .InvalidCastException

public:
 static DateTime ToDateTime(System::SByte value);

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

[<System.CLSCompliant(false)>]
static member ToDateTime : sbyte -> DateTime

Public Shared Function ToDateTime (value As SByte) As DateTime

Parâmetros

value: SByte

O inteiro com sinal de 8 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Atributos: CLSCompliantAttribute

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Byte

Aplica-se a

ToDateTime(UInt32)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Importante

Esta API não está em conformidade com CLS.

Chamar este método gera sempre .InvalidCastException

public:
 static DateTime ToDateTime(System::UInt32 value);

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

[<System.CLSCompliant(false)>]
static member ToDateTime : uint32 -> DateTime

Public Shared Function ToDateTime (value As UInteger) As DateTime

Parâmetros

value: UInt32

O inteiro não assinado de 32 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Atributos: CLSCompliantAttribute

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

UInt32

Aplica-se a

ToDateTime(Object)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Converte o valor do objeto especificado num DateTime objeto.

public:
 static DateTime ToDateTime(System::Object ^ value);

public static DateTime ToDateTime(object value);

public static DateTime ToDateTime(object? value);

static member ToDateTime : obj -> DateTime

Public Shared Function ToDateTime (value As Object) As DateTime

Parâmetros

value: Object

Um objeto que implementa a IConvertible interface, ou null.

Devoluções

DateTime

O equivalente data e hora do valor de value, ou um equivalente em data e hora de DateTime.MinValue se value for null.

Exceções

FormatException

value não é um valor válido de data e hora.

InvalidCastException

value não implementa a IConvertible interface.

-ou-

A conversão não é suportada.

Exemplos

O exemplo seguinte chama o ToDateTime(Object) método com uma variedade de Object variáveis.

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.

open System

let convertToDateTime (value: obj) =
    try
        let convertedDate = Convert.ToDateTime value
        printfn $"'{value}' converts to {convertedDate}."
    with
    | :? FormatException ->
        printfn $"'{value}' is not in the proper format."
    | :? InvalidCastException ->
        printfn $"Conversion of the {value.GetType().Name} '{value}' is not supported"

[<EntryPoint>]
let main _ =
    // Try converting an integer.
    let number = 16352
    convertToDateTime number

    // Convert a null.
    let obj = box null
    convertToDateTime obj

    // Convert a non-date string.
    let nonDateString = "monthly"
    convertToDateTime nonDateString

    // Try to convert various date strings.
    let dateString = "05/01/1996"
    convertToDateTime dateString
    let dateString = "Tue Apr 28, 2009"
    convertToDateTime dateString
    let dateString = "06 July 2008 7:32:47 AM"
    convertToDateTime dateString
    let dateString = "17:32:47.003"
    convertToDateTime dateString

    0

// 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.

Observações

Para que a conversão tenha sucesso, o tipo de execução do value parâmetro deve ser a DateTime ou a String, ou value deve ser null. Caso contrário, o método lança um InvalidCastException. Além disso, se value for uma cadeia, deve conter uma representação válida de um valor de data e hora na cultura atual ou é lançado FormatException .

O valor de retorno é o resultado da invocação do IConvertible.ToDateTime método do tipo subjacente de value.

Aplica-se a

ToDateTime(Double)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Double

O valor de ponto flutuante de dupla precisão a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Double

Aplica-se a

ToDateTime(Int32)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Int32

O inteiro assinado de 32 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Int32

Aplica-se a

ToDateTime(Int16)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Int16

O inteiro assinado de 16 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Int16

Aplica-se a

ToDateTime(Int64)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Int64

O inteiro com sinal de 64 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Int64

Aplica-se a

ToDateTime(Decimal)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Decimal

O número a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Aplica-se a

ToDateTime(DateTime)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Devolve o objeto especificado DateTime ; não é realizada nenhuma conversão real.

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

Parâmetros

value: DateTime

Um valor de data e hora.

Devoluções

DateTime

value é devolvido sem alterações.

Aplica-se a

ToDateTime(Char)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Char

O carácter Unicode a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Char

Aplica-se a

ToDateTime(Byte)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Byte

O inteiro sem sinal de 8 bits a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Byte

Aplica-se a

ToDateTime(Boolean)

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Origem:: Convert.cs

Chamar este método gera sempre .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

Parâmetros

value: Boolean

O valor booleano a converter.

Devoluções

DateTime

Esta conversão não é suportada. Nenhum valor é devolvido.

Exceções

InvalidCastException

Esta conversão não é suportada.

Ver também

Boolean

Aplica-se a

Comentários

Esta página foi útil?