Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Convert.ToDateTime (String, IFormatProvider)

 

Converte a representação de cadeia de caracteres especificada de um número em uma data e hora equivalentes, usando as informações de formatação específicas da cultura especificadas.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public static DateTime ToDateTime(
	string value,
	IFormatProvider provider
)

Parâmetros

value
Type: System.String

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

provider
Type: System.IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.

Valor de retorno

Type: System.DateTime

A data e hora equivalentes do valor de value, ou a data e hora equivalentes do DateTime.MinValue se value é null.

Exception Condition
FormatException

value não é uma data formatada corretamente e a cadeia de caracteres de hora.

O valor de retorno é o resultado de chamar o DateTime.Parse(String, IFormatProvider) método value.

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

Se você preferir não manipular uma exceção se a conversão falhar, você pode chamar o DateTime.TryParsemétodo em vez disso. Ele retorna um Boolean valor que indica se a conversão teve êxito ou falhou.

O exemplo a seguir converte representações de cadeia de caracteres 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();
      }
   }
}

Universal Windows Platform
Disponível desde 8
.NET Framework
Disponível desde 1.1
Portable Class Library
Com suporte em: portable .NET platforms
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao topo
Mostrar: