Convert.ToDateTime Метод

Определение

Пространство имен:: System

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.Extensions.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Сборки:: mscorlib.dll, System.Runtime.Extensions.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует указанное значение в DateTime значение.

Перегрузки

Имя	Описание
ToDateTime(Single)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(String)	Преобразует указанное строковое представление даты и времени в эквивалентное значение даты и времени.
ToDateTime(UInt16)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(String, IFormatProvider)	Преобразует указанное строковое представление числа в эквивалентную дату и время, используя указанные сведения о форматировании, зависящие от языка и региональных параметров.
ToDateTime(UInt64)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Object, IFormatProvider)	Преобразует значение указанного объекта в DateTime объект, используя указанные сведения о форматировании, зависящие от языка и региональных параметров.
ToDateTime(SByte)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(UInt32)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Object)	Преобразует значение указанного объекта в DateTime объект.
ToDateTime(Double)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Int32)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Int16)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Int64)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Decimal)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(DateTime)	Возвращает указанный DateTime объект; фактическое преобразование не выполняется.
ToDateTime(Char)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Byte)	Вызов этого метода всегда вызывает.InvalidCastException
ToDateTime(Boolean)	Вызов этого метода всегда вызывает.InvalidCastException

ToDateTime(Single)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(float value);

public static DateTime ToDateTime(float value);

static member ToDateTime : single -> DateTime

Public Shared Function ToDateTime (value As Single) As DateTime

Параметры

value: Single

Значение с плавающей запятой с одной точностью для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Single

Применяется к

ToDateTime(String)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Преобразует указанное строковое представление даты и времени в эквивалентное значение даты и времени.

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

Параметры

value: String

Строковое представление даты и времени.

Возвращаемое значение

DateTime

Значение даты и времени, эквивалентное значению valueили дате и времени, эквиваленту valuenull.

Исключения

FormatException

value не является правильно форматируемой строкой даты и времени.

Примеры

В следующем примере метод используется ToDateTime для преобразования различных строковых представлений дат и времени в DateTime значения.

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.

Если value это не nullтак, возвращаемое значение является результатом вызова DateTime.Parse метода value при использовании сведений о форматировании в DateTimeFormatInfo объекте, инициализированном для текущего языка и региональных параметров. Аргумент value должен содержать представление даты и времени в одном из форматов, описанных в DateTimeFormatInfo разделе. В противном value случае nullметод возвращается DateTime.MinValue.

Этот метод пытается полностью проанализировать value и избежать вызова FormatException. Он завершает отсутствующие сведения о месяце, день и год с текущей датой. Если value содержит только дату и нет времени, этот метод предполагает время полуночи. Любые начальные, внутренние или конечные символы пробелов игнорируются value .

Если вы предпочитаете не обрабатывать исключение, если преобразование завершается ошибкой, вместо этого можно вызвать DateTime.TryParse метод. Boolean Возвращает значение, указывающее, выполнено ли преобразование успешно или завершилось сбоем.

См. также раздел

Применяется к

ToDateTime(UInt16)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Важно!

Этот API несовместим с CLS.

Вызов этого метода всегда вызывает.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

Параметры

value: UInt16

16-разрядное целое число без знака для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Атрибуты: CLSCompliantAttribute

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

UInt16

Применяется к

ToDateTime(String, IFormatProvider)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Преобразует указанное строковое представление числа в эквивалентную дату и время, используя указанные сведения о форматировании, зависящие от языка и региональных параметров.

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

Параметры

value: String

Строка, содержащая дату и время преобразования.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров.

Возвращаемое значение

DateTime

Значение даты и времени, эквивалентное значению valueили дате и времени, эквиваленту valuenull.

Исключения

FormatException

value не является правильно форматируемой строкой даты и времени.

Примеры

В следующем примере преобразуются строковые представления значений даты с ToDateTime помощью метода с помощью IFormatProvider объекта.

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

provider IFormatProvider— это экземпляр, который получает DateTimeFormatInfo объект. Объект DateTimeFormatInfo предоставляет сведения о формате valueязыка и региональных параметров. Если provider это nullтак, DateTimeFormatInfo используется текущий язык и региональные параметры.

См. также раздел

Парсинг строк даты и времени в .NET

Применяется к

ToDateTime(UInt64)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Важно!

Этот API несовместим с CLS.

Вызов этого метода всегда вызывает.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

Параметры

value: UInt64

64-разрядное целое число без знака для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Атрибуты: CLSCompliantAttribute

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

UInt64

Применяется к

ToDateTime(Object, IFormatProvider)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Преобразует значение указанного объекта в DateTime объект, используя указанные сведения о форматировании, зависящие от языка и региональных параметров.

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

Параметры

value: Object

Объект, реализующий IConvertible интерфейс.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров.

Возвращаемое значение

DateTime

Значение даты и времени, эквивалентное значению valueили дате и времени, эквиваленту valuenull.

Исключения

FormatException

value не является допустимым значением даты и времени.

InvalidCastException

value не реализует IConvertible интерфейс.

–или–

Преобразование не поддерживается.

Примеры

В следующем примере определяется поставщик пользовательского формата, CustomProviderGetFormat метод которого выводит сообщение в консоль, которую он был вызван, а затем возвращает DateTimeFormatInfo объект языка и региональных параметров, имя которого было передано в качестве параметра конструктору класса. Каждый из этих CustomProvider объектов используется для преобразования элементов в массив объектов в значения даты и времени. Выходные данные указывают, что CustomProvider объект используется в преобразовании только в том случае, если тип value параметра является .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

provider позволяет пользователю указывать сведения о преобразовании, зависящие от valueязыка и региональных параметров. Например, если value дата String представляет дату, provider можно указать сведения о нотации, используемой для представления этой даты. provider участвует в преобразовании value , если тип value среды выполнения является типом Stringили value является определяемым пользователем типом, реализация которого IConvertible.ToDateTimeproviderиспользуется. Если тип value среды выполнения имеет и String является providernull, CultureInfo используется объект, представляющий текущий язык и региональные параметры.

См. также раздел

Парсинг строк даты и времени в .NET

Применяется к

ToDateTime(SByte)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Важно!

Этот API несовместим с CLS.

Вызов этого метода всегда вызывает.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

Параметры

value: SByte

8-разрядное целое число со знаком для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Атрибуты: CLSCompliantAttribute

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Byte

Применяется к

ToDateTime(UInt32)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Важно!

Этот API несовместим с CLS.

Вызов этого метода всегда вызывает.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

Параметры

value: UInt32

32-разрядное целое число без знака для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Атрибуты: CLSCompliantAttribute

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

UInt32

Применяется к

ToDateTime(Object)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Преобразует значение указанного объекта в DateTime объект.

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

Параметры

value: Object

Объект, реализующий IConvertible интерфейс или null.

Возвращаемое значение

DateTime

Значение даты и времени, эквивалентное значению valueили дате и времени, эквиваленту valuenull.

Исключения

FormatException

value не является допустимым значением даты и времени.

InvalidCastException

value не реализует IConvertible интерфейс.

–или–

Преобразование не поддерживается.

Примеры

В следующем примере метод вызывается ToDateTime(Object) с различными Object переменными.

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.

Для успешного value преобразования тип среды выполнения параметра должен быть либо aDateTime, либо Stringдолжен бытьvalue.null В противном случае метод создает исключение InvalidCastException. Кроме того, если value это строка, она должна содержать допустимое представление значения даты и времени в текущем языке и региональных параметрах или FormatException вызывается.

Возвращаемое значение является результатом вызова IConvertible.ToDateTime метода базового типа value.

Применяется к

ToDateTime(Double)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(double value);

public static DateTime ToDateTime(double value);

static member ToDateTime : double -> DateTime

Public Shared Function ToDateTime (value As Double) As DateTime

Параметры

value: Double

Преобразуемое значение с плавающей запятой двойной точности.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Double

Применяется к

ToDateTime(Int32)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(int value);

public static DateTime ToDateTime(int value);

static member ToDateTime : int -> DateTime

Public Shared Function ToDateTime (value As Integer) As DateTime

Параметры

value: Int32

32-разрядное целое число со знаком для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Int32

Применяется к

ToDateTime(Int16)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(short value);

public static DateTime ToDateTime(short value);

static member ToDateTime : int16 -> DateTime

Public Shared Function ToDateTime (value As Short) As DateTime

Параметры

value: Int16

16-разрядное целое число со знаком для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Int16

Применяется к

ToDateTime(Int64)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(long value);

public static DateTime ToDateTime(long value);

static member ToDateTime : int64 -> DateTime

Public Shared Function ToDateTime (value As Long) As DateTime

Параметры

value: Int64

64-разрядное целое число со знаком для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Int64

Применяется к

ToDateTime(Decimal)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

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

public static DateTime ToDateTime(decimal value);

static member ToDateTime : decimal -> DateTime

Public Shared Function ToDateTime (value As Decimal) As DateTime

Параметры

value: Decimal

Число для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

Применяется к

ToDateTime(DateTime)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Возвращает указанный DateTime объект; фактическое преобразование не выполняется.

public:
 static DateTime ToDateTime(DateTime value);

public static DateTime ToDateTime(DateTime value);

static member ToDateTime : DateTime -> DateTime

Public Shared Function ToDateTime (value As DateTime) As DateTime

Параметры

value: DateTime

Значение даты и времени.

Возвращаемое значение

DateTime

value возвращается без изменений.

Применяется к

ToDateTime(Char)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(char value);

public static DateTime ToDateTime(char value);

static member ToDateTime : char -> DateTime

Public Shared Function ToDateTime (value As Char) As DateTime

Параметры

value: Char

Символ Юникода для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Char

Применяется к

ToDateTime(Byte)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

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

public static DateTime ToDateTime(byte value);

static member ToDateTime : byte -> DateTime

Public Shared Function ToDateTime (value As Byte) As DateTime

Параметры

value: Byte

8-разрядное целое число без знака для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Byte

Применяется к

ToDateTime(Boolean)

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Исходный код:: Convert.cs

Вызов этого метода всегда вызывает.InvalidCastException

public:
 static DateTime ToDateTime(bool value);

public static DateTime ToDateTime(bool value);

static member ToDateTime : bool -> DateTime

Public Shared Function ToDateTime (value As Boolean) As DateTime

Параметры

value: Boolean

Логическое значение для преобразования.

Возвращаемое значение

DateTime

Это преобразование не поддерживается. Значение не возвращается.

Исключения

InvalidCastException

Это преобразование не поддерживается.

См. также раздел

Boolean

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Convert.ToDateTime Метод

Определение

Перегрузки

ToDateTime(Single)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToDateTime(UInt16)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(String, IFormatProvider)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToDateTime(UInt64)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(Object, IFormatProvider)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToDateTime(SByte)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(UInt32)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(Object)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

ToDateTime(Double)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(Int32)

Параметры

Возвращаемое значение

Исключения

См. также раздел

Применяется к

ToDateTime(Int16)

Параметры

Возвращаемое значение

Исключения