Convert.ToDateTime Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Převede zadanou hodnotu na DateTime hodnotu.

Přetížení

ToDateTime(Single)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(String)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalentní hodnotu data a času.
ToDateTime(UInt16)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(String, IFormatProvider)	Převede zadanou řetězcovou reprezentaci čísla na ekvivalentní datum a čas pomocí informací o formátování specifické pro konkrétní jazykovou verzi.
ToDateTime(UInt64)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Object, IFormatProvider)	Převede hodnotu zadaného objektu DateTime na objekt pomocí informací o formátování specifické pro zadanou jazykovou verzi.
ToDateTime(SByte)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(UInt32)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Object)	Převede hodnotu zadaného objektu DateTime na objekt.
ToDateTime(Int16)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Int32)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Int64)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Double)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Decimal)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(DateTime)	Vrátí zadaný DateTime objekt. Neprovádí se žádný skutečný převod.
ToDateTime(Char)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Byte)	Volání této metody vždy vyvolá InvalidCastException.
ToDateTime(Boolean)	Volání této metody vždy vyvolá InvalidCastException.

ToDateTime(Single)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Single

Hodnota s plovoucí desetinou čárkou s jednou přesností, která se má převést.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Single

Platí pro

ToDateTime(String)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Převede zadanou řetězcovou reprezentaci data a času na ekvivalentní hodnotu data a času.

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

Parametry

value: String

Řetězcová reprezentace data a času.

Návraty

DateTime

Ekvivalent data a času hodnoty value, nebo ekvivalent data a času DateTime.MinValue , pokud value je null.

Výjimky

FormatException

value není správně formátovaný řetězec data a času.

Příklady

Následující příklad používá metodu k převodu ToDateTime různých řetězcových reprezentací kalendářních dat a časů na DateTime hodnoty.

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.

Poznámky

Pokud value není null, návratová hodnota je výsledkem vyvolání DateTime.Parse metody value při použití informací o formátování v objektu DateTimeFormatInfo , který je inicializován pro aktuální jazykovou verzi. Argument value musí obsahovat reprezentaci data a času v jednom z formátů popsaných DateTimeFormatInfo v tématu. Pokud value je null, vrátí DateTime.MinValuemetoda .

Tato metoda se pokusí úplně parsovat value a vyhnout se vyvolání FormatException. Doplní chybějící informace o měsíci, dni a roce s aktuálním datem. Pokud value obsahuje pouze datum a žádný čas, tato metoda předpokládá čas půlnoci. Všechny počáteční, vnitřní nebo koncové prázdné znaky se value ignorují.

Pokud nechcete zpracovávat výjimku v případě selhání převodu, můžete místo toho volat metodu DateTime.TryParse . Vrátí Boolean hodnotu, která označuje, zda byl převod úspěšný nebo neúspěšný.

Viz také

Platí pro

ToDateTime(UInt16)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Volání této metody vždy vyvolá 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

Parametry

value: UInt16

16bitové celé číslo bez znaménka pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Atributy: CLSCompliantAttribute

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

UInt16

Platí pro

ToDateTime(String, IFormatProvider)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Převede zadanou řetězcovou reprezentaci čísla na ekvivalentní datum a čas pomocí informací o formátování specifické pro konkrétní jazykovou verzi.

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

Parametry

value: String

Řetězec, který obsahuje datum a čas k převedení.

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

DateTime

Ekvivalent data a času hodnoty value, nebo ekvivalent data a času DateTime.MinValue , pokud value je null.

Výjimky

FormatException

value není správně formátovaný řetězec data a času.

Příklady

Následující příklad převede řetězcové reprezentace hodnot kalendářních dat pomocí ToDateTime metody pomocí objektu 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

Poznámky

Návratová hodnota je výsledkem vyvolání metody na DateTime.Parse(String, IFormatProvider)value.

provider IFormatProvider je instance, která získá DateTimeFormatInfo objekt. Objekt DateTimeFormatInfo poskytuje informace specifické pro jazykovou verzi valueformátu . Pokud provider je null, použije se DateTimeFormatInfo pro aktuální jazykovou verzi.

Viz také

Analýza řetězců data a času v .NET

Platí pro

ToDateTime(UInt64)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Volání této metody vždy vyvolá 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

Parametry

value: UInt64

64bitové celé číslo bez znaménka pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Atributy: CLSCompliantAttribute

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

UInt64

Platí pro

ToDateTime(Object, IFormatProvider)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Převede hodnotu zadaného objektu DateTime na objekt pomocí informací o formátování specifické pro zadanou jazykovou verzi.

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

Parametry

value: Object

Objekt, který implementuje IConvertible rozhraní.

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

DateTime

Ekvivalent data a času hodnoty value, nebo ekvivalent data a času DateTime.MinValue , pokud value je null.

Výjimky

FormatException

value není platná hodnota data a času.

InvalidCastException

value neimplementuje IConvertible rozhraní.

-nebo-

Převod není podporován.

Příklady

Následující příklad definuje zprostředkovatele vlastního formátu , CustomProviderjehož GetFormat metoda vypíše zprávu do konzoly, že byla vyvolána, a pak vrátí DateTimeFormatInfo objekt jazykové verze, jejíž název byl předán jako parametr konstruktoru třídy. Každý z těchto CustomProvider objektů se používá k převodu prvků v poli objektů na hodnoty data a času. Výstup označuje, že CustomProvider objekt se používá při převodu pouze v případech, kdy je typem parametru valueString.

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

Poznámky

Návratová hodnota je výsledkem vyvolání IConvertible.ToDateTime metody základního valuetypu .

provider umožňuje uživateli zadat informace o převodu specifické pro jazykovou verzi obsahu nástroje value. Pokud value například představuje String datum, provider může poskytnout informace specifické pro jazykovou verzi o zápisu použitém k reprezentaci daného data. providerje zapojen do převodu, value pokud je Stringtyp value modulu runtime , nebo pokud value je uživatelem definovaný typ, jehož IConvertible.ToDateTime implementace využívá provider. Pokud typ modulu runtime value je String a provider je null, použije se CultureInfo objekt, který představuje aktuální jazykovou verzi.

Viz také

Analýza řetězců data a času v .NET

Platí pro

ToDateTime(SByte)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Volání této metody vždy vyvolá 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

Parametry

value: SByte

8bitové celé číslo se znaménkem pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Atributy: CLSCompliantAttribute

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Byte

Platí pro

ToDateTime(UInt32)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Volání této metody vždy vyvolá 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

Parametry

value: UInt32

32bitové celé číslo bez znaménka pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Atributy: CLSCompliantAttribute

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

UInt32

Platí pro

ToDateTime(Object)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Převede hodnotu zadaného objektu DateTime na objekt.

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

Parametry

value: Object

Objekt, který implementuje IConvertible rozhraní nebo null.

Návraty

DateTime

Ekvivalent data a času hodnoty value, nebo ekvivalent data a času DateTime.MinValue , pokud value je null.

Výjimky

FormatException

value není platná hodnota data a času.

InvalidCastException

value neimplementuje IConvertible rozhraní.

-nebo-

Převod není podporován.

Příklady

Následující příklad volá metodu ToDateTime(Object) s různými proměnnými 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.

Poznámky

Aby byl převod úspěšný, musí být typem value modulu runtime parametru DateTime Stringnebo , nebo value musí být null. V opačném případě metoda vyvolá .InvalidCastException Pokud je navíc value řetězec, musí obsahovat platnou reprezentaci hodnoty data a času v aktuální jazykové verzi nebo FormatException je vyvolán.

Návratová hodnota je výsledkem vyvolání IConvertible.ToDateTime metody základního valuetypu .

Platí pro

ToDateTime(Int16)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Int16

16bitové celé číslo se znaménkem pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Int16

Platí pro

ToDateTime(Int32)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Int32

32bitové celé číslo se znaménkem pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Int32

Platí pro

ToDateTime(Int64)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Int64

64bitové celé číslo se znaménkem pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Int64

Platí pro

ToDateTime(Double)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Double

Hodnota s plovoucí desetinou čárkou s dvojitou přesností, která se má převést.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Double

Platí pro

ToDateTime(Decimal)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Decimal

Číslo, které se má převést.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Platí pro

ToDateTime(DateTime)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Vrátí zadaný DateTime objekt. Neprovádí se žádný skutečný převod.

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

Parametry

value: DateTime

Hodnota data a času

Návraty

DateTime

value se vrátí beze změny.

Platí pro

ToDateTime(Char)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Char

Znak Unicode pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Char

Platí pro

ToDateTime(Byte)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Byte

8bitové celé číslo bez znaménka pro převod.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Byte

Platí pro

ToDateTime(Boolean)

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Zdroj:: Convert.cs

Volání této metody vždy vyvolá 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

Parametry

value: Boolean

Logická hodnota, kterou chcete převést.

Návraty

DateTime

Tento převod není podporován. Není vrácena žádná hodnota.

Výjimky

InvalidCastException

Tento převod není podporován.

Viz také

Boolean

Platí pro

Sdílet prostřednictvím

Convert.ToDateTime Metoda

Definice

Přetížení

ToDateTime(Single)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ToDateTime(UInt16)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(String, IFormatProvider)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ToDateTime(UInt64)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(Object, IFormatProvider)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ToDateTime(SByte)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(UInt32)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(Object)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

ToDateTime(Int16)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(Int32)

Parametry

Návraty

Výjimky

Viz také

Platí pro

ToDateTime(Int64)

Parametry

Návraty