DateTime.TryParseExact Methode

Quelle:

DateTime.cs

Quelle:

DateTime.cs

Quelle:

DateTime.cs

public:
 static bool TryParseExact(ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (ReadOnlySpan<char> s, ReadOnlySpan<char> format, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Parameter

Gibt zurück

true, wenn s erfolgreich konvertiert wurde; andernfalls false.

Quelle:

DateTime.cs

Quelle:

DateTime.cs

Quelle:

DateTime.cs

public:
 static bool TryParseExact(ReadOnlySpan<char> s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (ReadOnlySpan<char> s, string?[]? formats, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (ReadOnlySpan<char> s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As ReadOnlySpan(Of Char), formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Parameter

Gibt zurück

true, wenn der parameter s erfolgreich konvertiert wurde; andernfalls false.

Quelle:

DateTime.cs

Quelle:

DateTime.cs

Quelle:

DateTime.cs

public:
 static bool TryParseExact(System::String ^ s, System::String ^ format, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (string s, string format, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (string? s, string? format, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As String, format As String, provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Parameter

Gibt zurück

true, wenn s erfolgreich konvertiert wurde; andernfalls false.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)-Methode veranschaulicht. Beachten Sie, dass die Zeichenfolge " 5/01/2009 8:30 AM" nicht erfolgreich analysiert werden kann, wenn der styles Parameter gleich DateTimeStyles.None ist, da führende Leerzeichen von formatnicht zulässig sind. Darüber hinaus kann die Zeichenfolge "5/01/2009 09:00" nicht erfolgreich mit einem format von "MM/dd/yyyyhh:mm" analysiert werden, da die Datumszeichenfolge nicht vor der Monatsnummer mit einer führenden Null steht, wie format erfordert.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo enUS = new CultureInfo("en-US");
      string dateString;
      DateTime dateValue;

      // Parse date with no style flags.
      dateString = " 5/01/2009 8:30 AM";
      if (DateTime.TryParseExact(dateString, "g", enUS,
                                 DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Allow a leading space in the date string.
      if (DateTime.TryParseExact(dateString, "g", enUS,
                                 DateTimeStyles.AllowLeadingWhite, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Use custom formats with M and MM.
      dateString = "5/01/2009 09:00";
      if (DateTime.TryParseExact(dateString, "M/dd/yyyy hh:mm", enUS,
                                 DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Allow a leading space in the date string.
      if (DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm", enUS,
                              DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Parse a string with time zone information.
      dateString = "05/01/2009 01:30:42 PM -05:00";
      if (DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS,
                              DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Allow a leading space in the date string.
      if (DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS,
                              DateTimeStyles.AdjustToUniversal, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      // Parse a string representing UTC.
      dateString = "2008-06-11T16:11:20.0904778Z";
      if (DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture,
                                     DateTimeStyles.None, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);

      if (DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture,
                                 DateTimeStyles.RoundtripKind, out dateValue))
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue,
                           dateValue.Kind);
      else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString);
   }
}
// The example displays the following output:
//    ' 5/01/2009 8:30 AM' is not in an acceptable format.
//    Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
//    Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
//    '5/01/2009 09:00' is not in an acceptable format.
//    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
//    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
//    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
//    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).

open System
open System.Globalization

[<EntryPoint>]
let main _ =
    let enUS = CultureInfo "en-US"

    // Parse date with no style flags.
    let dateString = " 5/01/2009 8:30 AM"
    match DateTime.TryParseExact(dateString, "g", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."              
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Allow a leading space in the date string.
    match DateTime.TryParseExact(dateString, "g", enUS, DateTimeStyles.AllowLeadingWhite) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Use custom formats with M and MM.
    let dateString = "5/01/2009 09:00"
    match DateTime.TryParseExact(dateString, "M/dd/yyyy hh:mm", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Allow a leading space in the date string.
    match DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Parse a string with time zone information.
    let dateString = "05/01/2009 01:30:42 PM -05:00"
    match DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Allow a leading space in the date string.
    match DateTime.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, DateTimeStyles.AdjustToUniversal) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    // Parse a string representing UTC.
    let dateString = "2008-06-11T16:11:20.0904778Z"
    match DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    match DateTime.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue} ({dateValue.Kind})."
    | _ ->
        printfn $"'{dateString}' is not in an acceptable format."

    0

    // The example displays the following output:
    //    ' 5/01/2009 8:30 AM' is not in an acceptable format.
    //    Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
    //    Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
    //    '5/01/2009 09:00' is not in an acceptable format.
    //    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
    //    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
    //    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
    //    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).

Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim enUS As New CultureInfo("en-US") 
      Dim dateString As String
      Dim dateValue As Date
      
      ' Parse date with no style flags.
      dateString = " 5/01/2009 8:30 AM"
      If Date.TryParseExact(dateString, "g", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      ' Allow a leading space in the date string.
      If Date.TryParseExact(dateString, "g", enUS, _
                            DateTimeStyles.AllowLeadingWhite, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      
      ' Use custom formats with M and MM.
      dateString = "5/01/2009 09:00"
      If Date.TryParseExact(dateString, "M/dd/yyyy hh:mm", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      ' Allow a leading space in the date string.
      If Date.TryParseExact(dateString, "MM/dd/yyyy hh:mm", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If

      ' Parse a string with time zone information.
      dateString = "05/01/2009 01:30:42 PM -05:00" 
      If Date.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, _
                            DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      ' Allow a leading space in the date string.
      If Date.TryParseExact(dateString, "MM/dd/yyyy hh:mm:ss tt zzz", enUS, _
                            DateTimeStyles.AdjustToUniversal, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
           
      ' Parse a string representing UTC.
      dateString = "2008-06-11T16:11:20.0904778Z"
      If Date.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, _
                                     DateTimeStyles.None, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
      
      If Date.TryParseExact(dateString, "o", CultureInfo.InvariantCulture, _
                            DateTimeStyles.RoundtripKind, dateValue) Then
         Console.WriteLine("Converted '{0}' to {1} ({2}).", dateString, dateValue, _
                           dateValue.Kind)
      Else
         Console.WriteLine("'{0}' is not in an acceptable format.", dateString)
      End If
   End Sub
End Module
' The example displays the following output:
'    ' 5/01/2009 8:30 AM' is not in an acceptable format.
'    Converted ' 5/01/2009 8:30 AM' to 5/1/2009 8:30:00 AM (Unspecified).
'    Converted '5/01/2009 09:00' to 5/1/2009 9:00:00 AM (Unspecified).
'    '5/01/2009 09:00' is not in an acceptable format.
'    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 11:30:42 AM (Local).
'    Converted '05/01/2009 01:30:42 PM -05:00' to 5/1/2009 6:30:42 PM (Utc).
'    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 9:11:20 AM (Local).
'    Converted '2008-06-11T16:11:20.0904778Z' to 6/11/2008 4:11:20 PM (Utc).

Hinweise

Die DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)-Methode analysiert die Zeichenfolgendarstellung eines Datums, das sich im formatieren muss, das durch den parameter format definiert ist. Es ähnelt der DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles)-Methode, mit der Ausnahme, dass die TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)-Methode keine Ausnahme auslöst, wenn die Konvertierung fehlschlägt.

Der parameter s enthält das zu analysierende Datum und die Uhrzeit und muss sich in einem Format befinden, das vom parameter format definiert ist. Wenn Datums-, Uhrzeit- und Zeitzonenelemente in svorhanden sind, müssen sie auch in der von formatangegebenen Reihenfolge angezeigt werden. Wenn format ein Datum ohne Zeitelement definiert und der Analysevorgang erfolgreich ausgeführt wird, hat der resultierende DateTime Wert eine Uhrzeit von Mitternacht (00:00:00:00). Wenn format eine Uhrzeit ohne Datumselement definiert und der Analysevorgang erfolgreich ist, weist der resultierende DateTime-Wert standardmäßig ein Datum von DateTime.Now.Dateauf oder weist ein Datum der DateTime.MinValue.Date auf, wenn styles das DateTimeStyles.NoCurrentDateDefault Flag enthält. Der style-Parameter bestimmt, ob der s Parameter führende, innere oder nachfolgende Leerzeichen enthalten kann.

Wenn s keine Zeitzoneninformationen enthält, wird die Kind Eigenschaft des zurückgegebenen DateTime Objekts DateTimeKind.Unspecified. Dieses Verhalten kann mithilfe des DateTimeStyles.AssumeLocal-Flags geändert werden, das einen DateTime Wert zurückgibt, dessen Kind Eigenschaft DateTimeKind.Localist, oder mithilfe der Flags DateTimeStyles.AssumeUniversal und DateTimeStyles.AdjustToUniversal, die einen DateTime Wert zurückgibt, dessen Kind Eigenschaft DateTimeKind.Utcist. Wenn s Zeitzoneninformationen enthält, wird die Uhrzeit bei Bedarf in lokale Zeit konvertiert, und die Kind Eigenschaft des zurückgegebenen DateTime Objekts wird auf DateTimeKind.Localfestgelegt. Dieses Verhalten kann mithilfe des DateTimeStyles.RoundtripKind Flags geändert werden, um koordinierte Weltzeit (COORDINATED Universal Time, UTC) nicht in eine Ortszeit zu konvertieren und die eigenschaft Kind auf DateTimeKind.Utcfestzulegen.

Der parameter format enthält ein Muster, das dem erwarteten Format des s Parameters entspricht. Das Muster im format-Parameter besteht aus mindestens einem benutzerdefinierten Formatbezeichner aus den Benutzerdefinierten Datums- und Uhrzeitformatzeichenfolgen Tabelle oder einem einzelnen Standardformatbezeichner, der ein vordefiniertes Muster identifiziert, aus der Standarddatums- und Uhrzeitformatzeichenfolgen Tabelle.

Wenn Sie keine Datums- oder Uhrzeittrennzeichen in einem benutzerdefinierten Formatmuster verwenden, verwenden Sie die invariante Kultur für den parameter provider und die breiteste Form der einzelnen benutzerdefinierten Formatbezeichner. Wenn Sie z. B. Stunden im Muster angeben möchten, geben Sie das breitere Formular "HH" anstelle des schmaleren Formulars "H" an.

Die speziellen Datums- und Uhrzeitsymbole und Zeichenfolgen (z. B. die Namen der Wochentage in einer bestimmten Sprache) in s werden durch den parameter provider definiert, wie das genaue Format von s, wenn format eine Standardformatbezeichnerzeichenfolge ist. Der provider-Parameter kann eine der folgenden Sein:

• Ein CultureInfo-Objekt, das die Kultur darstellt, die zum Interpretieren sverwendet wird. Das von der DateTimeFormat -Eigenschaft zurückgegebene DateTimeFormatInfo -Objekt definiert die Symbole und Formatierungen in s.

• Ein DateTimeFormatInfo-Objekt, das das Format von Datums- und Uhrzeitdaten definiert.

• Eine benutzerdefinierte IFormatProvider Implementierung, deren GetFormat-Methode entweder das CultureInfo-Objekt oder das DateTimeFormatInfo-Objekt zurückgibt, das Formatierungsinformationen bereitstellt.

Wenn providernullist, wird das CultureInfo-Objekt verwendet, das der aktuellen Kultur entspricht.

Der styles Parameter enthält ein oder mehrere Elemente der DateTimeStyles Enumeration, die bestimmen, ob und wo Leerzeichen, die nicht durch format definiert werden, in s angezeigt werden können und das genaue Verhalten des Analysevorgangs steuern. In der folgenden Tabelle wird beschrieben, wie sich jedes Element der DateTimeStyles Enumeration auf den Vorgang der TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)-Methode auswirkt.

Hinweise für Aufrufer

In .NET Framework 4 gibt die TryParseExact-Methode false zurück, wenn die zu analysierende Zeichenfolge eine Stundenkomponente und einen AM/PM-Kennzeichner enthält, der nicht in Übereinstimmung ist. In .NET Framework 3.5 und früheren Versionen wird der AM/PM-Kennzeichner ignoriert.

Weitere Informationen

• ParseExact
• CultureInfo
• DateTimeFormatInfo
• Analysieren von Datums- und Uhrzeitzeichenfolgen im .NET Framework-
• Standard-Datums- und Uhrzeitformatzeichenfolgen
• benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen

Quelle:

DateTime.cs

Quelle:

DateTime.cs

Quelle:

DateTime.cs

public:
 static bool TryParseExact(System::String ^ s, cli::array <System::String ^> ^ formats, IFormatProvider ^ provider, System::Globalization::DateTimeStyles style, [Runtime::InteropServices::Out] DateTime % result);

public static bool TryParseExact (string s, string[] formats, IFormatProvider provider, System.Globalization.DateTimeStyles style, out DateTime result);

public static bool TryParseExact (string? s, string?[]? formats, IFormatProvider? provider, System.Globalization.DateTimeStyles style, out DateTime result);

static member TryParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTime -> bool

Public Shared Function TryParseExact (s As String, formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Parameter

Gibt zurück

true, wenn der parameter s erfolgreich konvertiert wurde; andernfalls false.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)-Methode verwendet, um sicherzustellen, dass eine Zeichenfolge in einer Reihe möglicher Formate erfolgreich analysiert werden kann.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] formats= {"M/d/yyyy h:mm:ss tt", "M/d/yyyy h:mm tt",
                         "MM/dd/yyyy hh:mm:ss", "M/d/yyyy h:mm:ss",
                         "M/d/yyyy hh:mm tt", "M/d/yyyy hh tt",
                         "M/d/yyyy h:mm", "M/d/yyyy h:mm",
                         "MM/dd/yyyy hh:mm", "M/dd/yyyy hh:mm"};
      string[] dateStrings = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM",
                              "5/1/2009 6:32:00", "05/01/2009 06:32",
                              "05/01/2009 06:32:00 PM", "05/01/2009 06:32:00"};
      DateTime dateValue;

      foreach (string dateString in dateStrings)
      {
         if (DateTime.TryParseExact(dateString, formats,
                                    new CultureInfo("en-US"),
                                    DateTimeStyles.None,
                                    out dateValue))
            Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue);
         else
            Console.WriteLine("Unable to convert '{0}' to a date.", dateString);
      }
   }
}
// The example displays the following output:
//       Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
//       Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.

open System
open System.Globalization

let formats= 
    [| "M/d/yyyy h:mm:ss tt"; "M/d/yyyy h:mm tt"
       "MM/dd/yyyy hh:mm:ss"; "M/d/yyyy h:mm:ss"
       "M/d/yyyy hh:mm tt"; "M/d/yyyy hh tt"
       "M/d/yyyy h:mm"; "M/d/yyyy h:mm"
       "MM/dd/yyyy hh:mm"; "M/dd/yyyy hh:mm" |]

let dateStrings = 
    [ "5/1/2009 6:32 PM"; "05/01/2009 6:32:05 PM"
      "5/1/2009 6:32:00"; "05/01/2009 06:32"
      "05/01/2009 06:32:00 PM"; "05/01/2009 06:32:00" ]

for dateString in dateStrings do
    match DateTime.TryParseExact(dateString, formats, CultureInfo "en-US", DateTimeStyles.None) with
    | true, dateValue ->
        printfn $"Converted '{dateString}' to {dateValue}."
    | _ ->
        printfn $"Unable to convert '{dateString}' to a date."


// The example displays the following output:
//       Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
//       Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
//       Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
//       Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.

Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim formats() As String = {"M/d/yyyy h:mm:ss tt", "M/d/yyyy h:mm tt", _
                                 "MM/dd/yyyy hh:mm:ss", "M/d/yyyy h:mm:ss", _
                                 "M/d/yyyy hh:mm tt", "M/d/yyyy hh tt", _
                                 "M/d/yyyy h:mm", "M/d/yyyy h:mm", _
                                 "MM/dd/yyyy hh:mm", "M/dd/yyyy hh:mm"}
      Dim dateStrings() As String = {"5/1/2009 6:32 PM", "05/01/2009 6:32:05 PM", _
                                     "5/1/2009 6:32:00", "05/01/2009 06:32", _
                                     "05/01/2009 06:32:00 PM", "05/01/2009 06:32:00"} 

      Dim dateValue As DateTime
      
      For Each dateString As String In dateStrings
         If Date.TryParseExact(dateString, formats, _
                               New CultureInfo("en-US"), _
                               DateTimeStyles.None, _
                               dateValue) Then
            Console.WriteLine("Converted '{0}' to {1}.", dateString, dateValue)
         Else
            Console.WriteLine("Unable to convert '{0}' to a date.", dateString)
         End If                                               
      Next
   End Sub   
End Module
' The example displays the following output:
'       Converted '5/1/2009 6:32 PM' to 5/1/2009 6:32:00 PM.
'       Converted '05/01/2009 6:32:05 PM' to 5/1/2009 6:32:05 PM.
'       Converted '5/1/2009 6:32:00' to 5/1/2009 6:32:00 AM.
'       Converted '05/01/2009 06:32' to 5/1/2009 6:32:00 AM.
'       Converted '05/01/2009 06:32:00 PM' to 5/1/2009 6:32:00 PM.
'       Converted '05/01/2009 06:32:00' to 5/1/2009 6:32:00 AM.

Hinweise

Die DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)-Methode analysiert die Zeichenfolgendarstellung eines Datums, das einem der dem formats-Parameter zugewiesenen Muster entspricht. Es ist wie die DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles)-Methode, mit der Ausnahme, dass die TryParseExact-Methode keine Ausnahme auslöst, wenn die Konvertierung fehlschlägt.

Der parameter s enthält das zu analysierende Datum und die Uhrzeit. Wenn der parameter s nur eine Uhrzeit und kein Datum enthält, wird das aktuelle Datum verwendet, es sei denn, der style Parameter enthält das DateTimeStyles.NoCurrentDateDefault Flag, in diesem Fall wird das Standarddatum (DateTime.Date.MinValue) verwendet. Wenn der parameter s nur ein Datum und keine Uhrzeit enthält, wird Mitternacht (00:00:00) verwendet. Der parameter style bestimmt auch, ob der s Parameter führende, innere oder nachfolgende Leerzeichen enthalten kann, die von einer der Formatzeichenfolgen in formatszulässig sind.

Wenn s keine Zeitzoneninformationen enthält, wird die Kind Eigenschaft des zurückgegebenen DateTime Objekts DateTimeKind.Unspecified. Dieses Verhalten kann mithilfe des DateTimeStyles.AssumeLocal-Flags geändert werden, das einen DateTime Wert zurückgibt, dessen Kind Eigenschaft DateTimeKind.Localist, oder mithilfe der Flags DateTimeStyles.AssumeUniversal und DateTimeStyles.AdjustToUniversal, die einen DateTime Wert zurückgibt, dessen Kind Eigenschaft DateTimeKind.Utcist. Wenn s Zeitzoneninformationen enthält, wird die Uhrzeit bei Bedarf in lokale Zeit konvertiert, und die Kind Eigenschaft des zurückgegebenen DateTime Objekts wird auf DateTimeKind.Localfestgelegt. Dieses Verhalten kann mithilfe des DateTimeStyles.RoundtripKind Flags geändert werden, um koordinierte Weltzeit (COORDINATED Universal Time, UTC) nicht in eine Ortszeit zu konvertieren und die eigenschaft Kind auf DateTimeKind.Utcfestzulegen.

Der formats-Parameter enthält ein Array von Mustern, von denen s genau übereinstimmen müssen, wenn der Analysevorgang erfolgreich ist. Die Muster im formats Parameter bestehen aus einem oder mehreren benutzerdefinierten Formatbezeichnern aus den Benutzerdefinierten Datums- und Uhrzeitformatzeichenfolgen Tabelle oder einem einzelnen Standardformatbezeichner, der ein vordefiniertes Muster identifiziert, aus der Standarddatums- und Uhrzeitformatzeichenfolgen Tabelle.

Wenn Sie keine Datums- oder Uhrzeittrennzeichen in einem benutzerdefinierten Formatmuster verwenden, verwenden Sie die invariante Kultur für den parameter provider und die breiteste Form der einzelnen benutzerdefinierten Formatbezeichner. Wenn Sie z. B. Stunden im Muster angeben möchten, geben Sie das breitere Formular "HH" anstelle des schmaleren Formulars "H" an.

Die speziellen Datums- und Uhrzeitsymbole und Zeichenfolgen (z. B. die Namen der Wochentage in einer bestimmten Sprache) in s werden durch den parameter provider definiert, wie das genaue Format von s, wenn format eine Standardformatbezeichnerzeichenfolge ist. Der provider-Parameter kann eine der folgenden Sein:

• Ein CultureInfo-Objekt, das die Kultur darstellt, die zum Interpretieren sverwendet wird. Das von der DateTimeFormat -Eigenschaft zurückgegebene DateTimeFormatInfo -Objekt definiert die Symbole und Formatierungen in s.

• Ein DateTimeFormatInfo-Objekt, das das Format von Datums- und Uhrzeitdaten definiert.

• Eine benutzerdefinierte IFormatProvider Implementierung, deren GetFormat-Methode entweder das CultureInfo-Objekt oder das DateTimeFormatInfo-Objekt zurückgibt, das Formatierungsinformationen bereitstellt.

Wenn providernullist, wird das CultureInfo-Objekt verwendet, das der aktuellen Kultur entspricht.

Der styles Parameter enthält ein oder mehrere Elemente der DateTimeStyles Enumeration, die bestimmen, ob und wo Leerzeichen, die nicht durch format definiert werden, in s angezeigt werden können und das genaue Verhalten des Analysevorgangs steuern. In der folgenden Tabelle wird beschrieben, wie sich jedes Element der DateTimeStyles Enumeration auf den Vorgang der TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)-Methode auswirkt.

Hinweise für Aufrufer

In .NET Framework 4 gibt die TryParseExact-Methode false zurück, wenn die zu analysierende Zeichenfolge eine Stundenkomponente und einen AM/PM-Kennzeichner enthält, der nicht in Übereinstimmung ist. In .NET Framework 3.5 und früheren Versionen wird der AM/PM-Kennzeichner ignoriert.

Weitere Informationen

• ParseExact
• CultureInfo
• DateTimeFormatInfo
• Analysieren von Datums- und Uhrzeitzeichenfolgen im .NET Framework-
• Standard-Datums- und Uhrzeitformatzeichenfolgen
• benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen