DateTime.TryParseExact DateTime.TryParseExact DateTime.TryParseExact DateTime.TryParseExact Method

Definition

Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe in die DateTime-Entsprechung.Converts the specified string representation of a date and time to its DateTime equivalent. Das Format der Zeichenfolgendarstellung muss einem angegebenen Format genau entsprechen.The format of the string representation must match a specified format exactly. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.The method returns a value that indicates whether the conversion succeeded.

Überlädt

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in die entsprechende DateTime.Converts the specified string representation of a date and time to its DateTime equivalent using the specified format, culture-specific format information, and style. Das Format der Zeichenfolgendarstellung muss dem angegebenen Format genau entsprechen.The format of the string representation must match the specified format exactly. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.The method returns a value that indicates whether the conversion succeeded.

TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formatarrays, der kulturspezifischen Formatierungsinformationen und des Stils in die DateTime-Entsprechung.Converts the specified string representation of a date and time to its DateTime equivalent using the specified array of formats, culture-specific format information, and style. Das Format der Zeichenfolgendarstellung muss mindestens einem der angegebenen Formate genau entsprechen.The format of the string representation must match at least one of the specified formats exactly. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.The method returns a value that indicates whether the conversion succeeded.

Hinweise

Wichtig

Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden.Such a change of era affects all applications that use these calendars. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weiter Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Unter Prepare your application for the Japanese era change (Vorbereiten Ihrer Anwendung für die Änderung des Zeitabschnitts im japanischen Kalender) finden Sie Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um deren Bereitschaft für die Änderung im Zeitabschnitt sicherzustellen.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Unter Arbeiten mit Zeiträumen finden Sie Informationen zu Funktionen in .NET, die Kalender mit mehreren Zeitabschnitten unterstützen, sowie bewährte Vorgehensweisen bei der Arbeit mit solchen Kalendern.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

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);
static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles *  -> 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

format
ReadOnlySpan<Char>

Gibt zurück

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)

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);
static member TryParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles *  -> 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

formats
String[]

Gibt zurück

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in die entsprechende DateTime.Converts the specified string representation of a date and time to its DateTime equivalent using the specified format, culture-specific format information, and style. Das Format der Zeichenfolgendarstellung muss dem angegebenen Format genau entsprechen.The format of the string representation must match the specified format exactly. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.The method returns a value that indicates whether the conversion succeeded.

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);
static member TryParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles *  -> bool
Public Shared Function TryParseExact (s As String, format As String, provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Parameter

s
String String String String

Eine Zeichenfolge, die eine zu konvertierende Datums- und Zeitangabe enthält.A string containing a date and time to convert.

format
String String String String

Das erforderliche Format von s.The required format of s.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.An object that supplies culture-specific formatting information about s.

style
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

Eine bitweise Kombination eines oder mehrerer Enumerationswerte, die das für s zulässige Format angeben.A bitwise combination of one or more enumeration values that indicate the permitted format of s.

result
DateTime DateTime DateTime DateTime

Diese Methode gibt bei erfolgreicher Konvertierung den DateTime-Wert zurück, der dem Datum und der Zeit in s entspricht, oder MinValue, wenn die Konvertierung nicht durchgeführt werden konnte.When this method returns, contains the DateTime value equivalent to the date and time contained in s, if the conversion succeeded, or MinValue if the conversion failed. Die Konvertierung schlägt fehl, wenn der s-Parameter oder der format-Parameter null ist, eine leere Zeichenfolge ist oder keine Datums- und Zeitangabe in dem in format angegebenen Format enthält.The conversion fails if either the s or format parameter is null, is an empty string, or does not contain a date and time that correspond to the pattern specified in format. Dieser Parameter wird nicht initialisiert übergeben.This parameter is passed uninitialized.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

Ausnahmen

styles ist kein gültiger DateTimeStyles-Wert.styles is not a valid DateTimeStyles value.

- oder --or- styles enthält eine ungültige Kombination von DateTimeStyles-Werten (z. B. AssumeLocal und AssumeUniversal).styles contains an invalid combination of DateTimeStyles values (for example, both AssumeLocal and AssumeUniversal).

Beispiele

Das folgende Beispiel veranschaulicht die DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) Methode.The following example demonstrates the DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method. Beachten Sie, dass die Zeichenfolge "5/01/2009 8:30 am" nicht erfolgreich analysiert werden styles kann, DateTimeStyles.None wenn der-Parameter gleich ist, formatda führende Leerzeichen von nicht zugelassen werden.Note that the string " 5/01/2009 8:30 AM" cannot be parsed successfully when the styles parameter equals DateTimeStyles.None because leading spaces are not allowed by format. Außerdem kann die Zeichenfolge "5/01/2009 09:00" nicht erfolgreich mit einem format von "mm/dd/yyyyhh: mm" analysiert werden, da die Datums Zeichenfolge nicht der Monatsnummer vorangestellt ist, wie format dies erfordert.Additionally, the string "5/01/2009 09:00" cannot be parsed successfully with a format of "MM/dd/yyyyhh:mm" because the date string does not precede the month number with a leading zero, as format requires.

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).
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 Zeichen folgen Darstellung eines Datums, das in dem Format vorliegen muss, das durch format den-Parameter definiert wird.The DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method parses the string representation of a date, which must be in the format defined by the format parameter. Die-Methode ähnelt der DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) -Methode, mit der TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) Ausnahme, dass die-Methode keine Ausnahme auslöst, wenn bei der Konvertierung ein Fehler auftritt.It is similar to the DateTime.ParseExact(String, String, IFormatProvider, DateTimeStyles) method, except that the TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method does not throw an exception if the conversion fails.

Der s -Parameter enthält das zu erteilende Datum und die Uhrzeit und muss in einem Format vorliegen format , das durch den-Parameter definiert wird.The s parameter contains the date and time to parse and must be in a format defined by the format parameter. Wenn Datums-, Uhrzeit-und Zeit Zonen Elemente in svorhanden sind, müssen Sie auch in der von formatangegebenen Reihenfolge angezeigt werden.If date, time, and time zone elements are present in s, they must also appear in the order specified by format. Wenn format ein Datum ohne Zeitelement definiert und der Analyse Vorgang erfolgreich ist, hat der resultierende DateTime Wert eine Uhrzeit von Mitternacht (00:00:00).If format defines a date with no time element and the parse operation succeeds, the resulting DateTime value has a time of midnight (00:00:00). Wenn format eine Uhrzeit ohne Date-Element definiert und der Analyse Vorgang erfolgreich ist, hat der DateTime resultierende Wert DateTime.Now.Datestandardmäßig das Datum oder das Datum DateTime.MinValue.Date , wenn styles das DateTimeStyles.NoCurrentDateDefault -Flag enthält.If format defines a time with no date element and the parse operation succeeds, the resulting DateTime value by default has a date of DateTime.Now.Date, or it has a date of DateTime.MinValue.Date if styles includes the DateTimeStyles.NoCurrentDateDefault flag. Der style -Parameter bestimmt, s ob der Parameter führende, innere oder nachfolgende leer Raum Zeichen enthalten kann.The style parameter determines whether the s parameter can contain leading, inner, or trailing white space characters.

Wenn s keine Zeitzoneninformationen enthält, ist Kind DateTimeKind.Unspecifieddie-Eigenschaft des DateTime zurückgegebenen-Objekts.If s contains no time zone information, the Kind property of the returned DateTime object is DateTimeKind.Unspecified. Dieses Verhalten kann DateTimeStyles.AssumeLocal mit dem-Flag geändert werden, das einen DateTime Wert zurückgibt Kind , dessen DateTimeKind.Local-Eigenschaft ist, oder DateTimeStyles.AssumeUniversal indem DateTimeStyles.AdjustToUniversal die-und-Flags DateTime verwendet werden, die einen Wert zurückgeben, dessen die-Eigenschaft ist DateTimeKind.Utc. KindThis behavior can be changed by using the DateTimeStyles.AssumeLocal flag, which returns a DateTime value whose Kind property is DateTimeKind.Local, or by using the DateTimeStyles.AssumeUniversal and DateTimeStyles.AdjustToUniversal flags, which returns a DateTime value whose Kind property is DateTimeKind.Utc. Wenn s Zeitzoneninformationen enthält, wird die Uhrzeit ggf. in lokale Zeit konvertiert, und die Kind -Eigenschaft des zurück DateTime gegebenen-Objekts wird DateTimeKind.Localauf festgelegt.If s contains time zone information, the time is converted to local time, if necessary, and the Kind property of the returned DateTime object is set to DateTimeKind.Local. Dieses Verhalten kann geändert werden, indem das DateTimeStyles.RoundtripKind -Flag verwendet wird, um die koordinierte Weltzeit (UTC) nicht in eine Ortszeit Kind zu konvertieren DateTimeKind.Utcund die-Eigenschaft auf festzulegen.This behavior can be changed by using the DateTimeStyles.RoundtripKind flag to not convert Coordinated Universal Time (UTC) to a local time and set the Kind property to DateTimeKind.Utc.

Der format -Parameter enthält ein Muster, das dem erwarteten Format s des-Parameters entspricht.The format parameter contains a pattern that corresponds to the expected format of the s parameter. Das Muster im format -Parameter besteht aus einem oder mehreren benutzerdefinierten Format Bezeichnern aus der benutzerdefinierten Format Zeichenfolgen-Tabelle für Datum und Uhrzeit oder einem einzelnen Standardformat Bezeichner, der ein vordefiniertes Muster identifiziert, vom Standard Datum und Tabelle mit Zeit Format Zeichenfolgen.The pattern in the format parameter consists of one or more custom format specifiers from the Custom Date and Time Format Strings table, or a single standard format specifier, which identifies a predefined pattern, from the Standard Date and Time Format Strings table.

Wenn Sie keine Datums-oder Uhrzeit Trennzeichen in einem benutzerdefinierten Format Muster verwenden, verwenden Sie die invariante Kultur provider für den Parameter und die breiteste Form der einzelnen benutzerdefinierten Format Bezeichner.If you do not use date or time separators in a custom format pattern, use the invariant culture for the provider parameter and the widest form of each custom format specifier. Wenn Sie z. b. Stunden im Muster angeben möchten, geben Sie die breitere Form "hh" anstelle des engeren Formulars "H" an.For example, if you want to specify hours in the pattern, specify the wider form, "HH", instead of the narrower form, "H".

Hinweis

Anstatt die s Konformität eines einzelnen Formats zu erfordern, damit der Analyse Vorgang erfolgreich ausgeführt werden kann, können Sie die DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) -Methode aufzurufen und mehrere zulässige Formate angeben.Rather than requiring that s conform to a single format for the parse operation to succeed, you can call the DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) method and specify multiple permitted formats. Dadurch wird die Wahrscheinlichkeit, dass der Analyse Vorgang erfolgreich durchgeführt wird.This makes the parse operation more likely to succeed.

Die bestimmten Datums-und Uhrzeit Symbole und-Zeichen folgen (z. b. die Namen der Wochentage in einer bestimmten Sprache) s , die in verwendet provider werden, werden durch den-Parameter definiert s , format ebenso wie das genaue Format von, wenn ein Standardformat ist. spezifiziererzeichenfolge.The particular date and time symbols and strings (such as the names of the days of the week in a particular language) used in s are defined by the provider parameter, as is the precise format of s if format is a standard format specifier string. Der provider -Parameter kann eine der folgenden sein:The provider parameter can be any of the following:

Wenn providerden Wert CultureInfo hat, wird das-Objekt verwendet, das der aktuellen Kultur entspricht. nullIf provider is null, the CultureInfo object that corresponds to the current culture is used.

Der styles -Parameter enthält mindestens einen Member DateTimeStyles der-Enumeration, der bestimmt, ob und wo Leerraum, format der nicht von s definiert wird, in angezeigt werden kann und das genaue Verhalten des Analyse Vorgangs steuert.The styles parameter includes one or more members of the DateTimeStyles enumeration that determine whether and where white space not defined by format can appear in s and that control the precise behavior of the parse operation. In der folgenden Tabelle wird beschrieben, wie sich DateTimeStyles jedes Member der-Enumeration TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) auf den Vorgang der-Methode auswirkt.The following table describes how each member of the DateTimeStyles enumeration affects the operation of the TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method.

DateTimeStyles-MemberDateTimeStyles member BeschreibungDescription
AdjustToUniversal s Analysiert und konvertiert ggf. in UTC.Parses s and, if necessary, converts it to UTC. Wenn s einen Zeit Zonen Offset enthält oder wenn s keine Zeitzoneninformationen enthält, sondern styles das DateTimeStyles.AssumeLocal -Flag enthält, analysiert die-Methode die Zeichenfolge ToUniversalTime , und ruft auf DateTime , um den zurückgegebenen Wert in UTC zu konvertieren. , und legt die Kind -Eigenschaft DateTimeKind.Utcauf fest.If s includes a time zone offset, or if s contains no time zone information but styles includes the DateTimeStyles.AssumeLocal flag, the method parses the string, calls ToUniversalTime to convert the returned DateTime value to UTC, and sets the Kind property to DateTimeKind.Utc. Wenn s angibt, dass es sich um UTC handelt s , oder wenn keine Zeitzoneninformationen styles enthält, DateTimeStyles.AssumeUniversal sondern das-Flag enthält, analysiert die Methode die Zeichenfolge, führt keine Zeit Zonen DateTime Konvertierung für die zurückgegebene aus. , und legt die Kind -Eigenschaft auf DateTimeKind.Utcfest.If s indicates that it represents UTC, or if s does not contain time zone information but styles includes the DateTimeStyles.AssumeUniversal flag, the method parses the string, performs no time zone conversion on the returned DateTime value, and sets the Kind property to DateTimeKind.Utc. In allen anderen Fällen hat das Flag keine Auswirkung.In all other cases, the flag has no effect.
AllowInnerWhite Gibt an, dass der von nicht format definierte Leerraum zwischen einem einzelnen Date-oder Time-Element angezeigt werden kann.Specifies that white space not defined by format can appear between any individual date or time element.
AllowLeadingWhite Gibt an, dass Leerzeichen, format die nicht von definiert werden, sam Anfang von angezeigt werden können.Specifies that white space not defined by format can appear at the beginning of s.
AllowTrailingWhite Gibt an, dass Leerzeichen, format die nicht von definiert werden, sam Ende von angezeigt werden können.Specifies that white space not defined by format can appear at the end of s.
AllowWhiteSpaces Gibt an s , dass möglicherweise führende, innere und nachfolgende Leerzeichen enthält format, die nicht von definiert werden.Specifies that s may contain leading, inner, and trailing white spaces not defined by format.
AssumeLocal Gibt an, s dass, wenn keine Zeitzoneninformationen fehlt, angenommen wird, dass es sich um eine lokale Zeit handelt.Specifies that if s lacks any time zone information, it is assumed to represent a local time. Wenn das DateTimeStyles.AdjustToUniversal -Flag nicht vorhanden ist Kind , wird die- DateTime Eigenschaft des zurückgegebenen DateTimeKind.LocalWerts auf festgelegt.Unless the DateTimeStyles.AdjustToUniversal flag is present, the Kind property of the returned DateTime value is set to DateTimeKind.Local.
AssumeUniversal Gibt an, s dass, wenn keine Zeitzoneninformationen fehlt, angenommen wird, dass die UTC-Zeitangabe erfolgt.Specifies that if s lacks any time zone information, it is assumed to represent UTC. Wenn das DateTimeStyles.AdjustToUniversal -Flag nicht vorhanden ist, konvertiert die- DateTime Methode den zurückgegebenen Wert von UTC in die Kind lokale Zeit DateTimeKind.Localund legt seine-Eigenschaft auf fest.Unless the DateTimeStyles.AdjustToUniversal flag is present, the method converts the returned DateTime value from UTC to local time and sets its Kind property to DateTimeKind.Local.
NoCurrentDateDefault Wenn s Zeit ohne Datumsangaben enthält, wird das Datum des Rückgabewerts auf DateTime.MinValue.Datefestgelegt.If s contains time without date information, the date of the return value is set to DateTime.MinValue.Date.
None Der s -Parameter wird mit Standardwerten analysiert.The s parameter is parsed using default values. Es ist kein Leerraum zulässig, der format in vorhanden ist.No white space other than that present in format is allowed. Wenn s eine Datums Komponente fehlt, wird das Datum des zurück DateTime gegebenen Werts auf 1/1/0001 festgelegt.If s lacks a date component, the date of the returned DateTime value is set to 1/1/0001. Wenn s keine Zeitzoneninformationen enthält, wird Kind die-Eigenschaft des DateTime zurückgegebenen-Objekts DateTimeKind.Unspecifiedauf festgelegt.If s contains no time zone information, the Kind property of the returned DateTime object is set to DateTimeKind.Unspecified. Wenn Zeitzoneninformationen sin vorhanden sind, wird die Uhrzeit in die Ortszeit konvertiert, und die Kind -Eigenschaft des DateTime zurückgegebenen-Objekts DateTimeKind.Localwird auf festgelegt.If time zone information is present in s, the time is converted to local time and the Kind property of the returned DateTime object is set to DateTimeKind.Local.
RoundtripKind Bei Zeichen folgen, die Zeitzoneninformationen enthalten, versucht, die Konvertierung in DateTime einen-Wert Kind zu verhindern, DateTimeKind.Localdessen-Eigenschaft auf festgelegt ist.For strings that contain time zone information, tries to prevent the conversion to a DateTime value with its Kind property set to DateTimeKind.Local. Dieses Flag verhindert hauptsächlich die Konvertierung von UTC-Zeiten in lokale Uhrzeiten.This flag primarily prevents the conversion of UTC times to local times.

Hinweise für Aufrufer

In gibt die TryParseExact -Methode zurück false , wenn die zu erteilende Zeichenfolge eine Stunden Komponente und einen am/pm-Kenn Zeichner enthält, der nicht in der Vereinbarung ist. .NET Framework 4.NET Framework 4In the .NET Framework 4.NET Framework 4, the TryParseExact method returns false if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. .NET Framework 3,5.NET Framework 3.5 In und früheren Versionen wird der am/pm-Kenn Zeichner ignoriert.In the .NET Framework 3,5.NET Framework 3.5 and earlier versions, the AM/PM designator is ignored.

Siehe auch

TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formatarrays, der kulturspezifischen Formatierungsinformationen und des Stils in die DateTime-Entsprechung.Converts the specified string representation of a date and time to its DateTime equivalent using the specified array of formats, culture-specific format information, and style. Das Format der Zeichenfolgendarstellung muss mindestens einem der angegebenen Formate genau entsprechen.The format of the string representation must match at least one of the specified formats exactly. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.The method returns a value that indicates whether the conversion succeeded.

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);
static member TryParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles *  -> bool
Public Shared Function TryParseExact (s As String, formats As String(), provider As IFormatProvider, style As DateTimeStyles, ByRef result As DateTime) As Boolean

Parameter

s
String String String String

Eine Zeichenfolge, die eine zu konvertierende Datums- und Zeitangabe enthält.A string that contains a date and time to convert.

formats
String[]

Ein Array mit den zulässigen Formaten von s.An array of allowable formats of s.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.An object that supplies culture-specific format information about s.

style
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s angibt.A bitwise combination of enumeration values that indicates the permitted format of s. Ein häufig angegebener Wert ist None.A typical value to specify is None.

result
DateTime DateTime DateTime DateTime

Diese Methode gibt bei erfolgreicher Konvertierung den DateTime-Wert zurück, der dem Datum und der Zeit in s entspricht, oder MinValue, wenn die Konvertierung nicht durchgeführt werden konnte.When this method returns, contains the DateTime value equivalent to the date and time contained in s, if the conversion succeeded, or MinValue if the conversion failed. Die Konvertierung schlägt fehl, wenn s oder formatsnull ist, wenn s oder ein Element von formats eine leere Zeichenfolge ist, oder wenn das Format von s nicht genau mindestens einem der Formatmuster in formats entspricht.The conversion fails if s or formats is null, s or an element of formats is an empty string, or the format of s is not exactly as specified by at least one of the format patterns in formats. Dieser Parameter wird nicht initialisiert übergeben.This parameter is passed uninitialized.

Gibt zurück

true, wenn der s-Parameter erfolgreich konvertiert wurde, andernfalls false.true if the s parameter was converted successfully; otherwise, false.

Ausnahmen

styles ist kein gültiger DateTimeStyles-Wert.styles is not a valid DateTimeStyles value.

- oder --or- styles enthält eine ungültige Kombination von DateTimeStyles-Werten (z. B. AssumeLocal und AssumeUniversal).styles contains an invalid combination of DateTimeStyles values (for example, both AssumeLocal and AssumeUniversal).

Beispiele

Im folgenden Beispiel wird die DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) -Methode verwendet, um sicherzustellen, dass eine Zeichenfolge in mehreren möglichen Formaten erfolgreich analysiert werden kann.The following example uses the DateTime.TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) method to ensure that a string in a number of possible formats can be successfully parsed .

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.
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 Zeichen folgen Darstellung eines Datums, das mit einem der Muster übereinstimmt, die formats dem-Parameter zugewiesen sind.The DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) method parses the string representation of a date that matches any one of the patterns assigned to the formats parameter. Dies entspricht der DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) -Methode, mit der TryParseExact Ausnahme, dass die-Methode keine Ausnahme auslöst, wenn die Konvertierung fehlschlägt.It is like the DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method, except the TryParseExact method does not throw an exception if the conversion fails.

Der s -Parameter enthält das Datum und die Uhrzeit, die analysiert werden sollen.The s parameter contains the date and time to parse. Wenn der s -Parameter nur eine Uhrzeit und kein Datum enthält, wird das aktuelle Datum verwendet, style es sei denn DateTimeStyles.NoCurrentDateDefault , der Parameter enthält das-Flag. inDateTime.Date.MinValuediesem Fall wird das Standard Datum () verwendet.If the s parameter contains only a time and no date, the current date is used unless the style parameter includes the DateTimeStyles.NoCurrentDateDefault flag, in which case the default date (DateTime.Date.MinValue) is used. Wenn der s -Parameter nur ein Datum und keine Uhrzeit enthält, wird Mitternacht (00:00:00) verwendet.If the s parameter contains only a date and no time, midnight (00:00:00) is used. Der style -Parameter bestimmt auch, s ob der-Parameter führende, innere oder nachfolgende leer Raum Zeichen enthalten kann, die nicht von einer der Format Zeichenfolgen in formatszulässig sind.The style parameter also determines whether the s parameter can contain leading, inner, or trailing white space characters other than those permitted by one of the format strings in formats.

Wenn s keine Zeitzoneninformationen enthält, ist Kind DateTimeKind.Unspecifieddie-Eigenschaft des DateTime zurückgegebenen-Objekts.If s contains no time zone information, the Kind property of the returned DateTime object is DateTimeKind.Unspecified. Dieses Verhalten kann DateTimeStyles.AssumeLocal mit dem-Flag geändert werden, das einen DateTime Wert zurückgibt Kind , dessen DateTimeKind.Local-Eigenschaft ist, oder DateTimeStyles.AssumeUniversal indem DateTimeStyles.AdjustToUniversal die-und-Flags DateTime verwendet werden, die einen Wert zurückgeben, dessen die-Eigenschaft ist DateTimeKind.Utc. KindThis behavior can be changed by using the DateTimeStyles.AssumeLocal flag, which returns a DateTime value whose Kind property is DateTimeKind.Local, or by using the DateTimeStyles.AssumeUniversal and DateTimeStyles.AdjustToUniversal flags, which returns a DateTime value whose Kind property is DateTimeKind.Utc. Wenn s Zeitzoneninformationen enthält, wird die Uhrzeit ggf. in lokale Zeit konvertiert, und die Kind -Eigenschaft des zurück DateTime gegebenen-Objekts wird DateTimeKind.Localauf festgelegt.If s contains time zone information, the time is converted to local time, if necessary, and the Kind property of the returned DateTime object is set to DateTimeKind.Local. Dieses Verhalten kann geändert werden, indem das DateTimeStyles.RoundtripKind -Flag verwendet wird, um die koordinierte Weltzeit (UTC) nicht in eine Ortszeit Kind zu konvertieren DateTimeKind.Utcund die-Eigenschaft auf festzulegen.This behavior can be changed by using the DateTimeStyles.RoundtripKind flag to not convert Coordinated Universal Time (UTC) to a local time and set the Kind property to DateTimeKind.Utc.

Der formats -Parameter enthält ein Array von Mustern, von denen s einer genau übereinstimmen muss, wenn der Analyse Vorgang erfolgreich durchgeführt werden soll.The formats parameter contains an array of patterns, one of which s must match exactly if the parse operation is to succeed. Die Muster im formats -Parameter bestehen aus einem oder mehreren benutzerdefinierten Format Bezeichnern aus der benutzerdefinierten Format Zeichenfolgen-Tabelle für Datum und Uhrzeit oder einem einzelnen Standardformat Bezeichner, der ein vordefiniertes Muster identifiziert, vom Standard Datum und Tabelle mit Zeit Format Zeichenfolgen.The patterns in the formats parameter consist of one or more custom format specifiers from the Custom Date and Time Format Strings table, or a single standard format specifier, which identifies a predefined pattern, from the Standard Date and Time Format Strings table.

Wenn Sie keine Datums-oder Uhrzeit Trennzeichen in einem benutzerdefinierten Format Muster verwenden, verwenden Sie die invariante Kultur provider für den Parameter und die breiteste Form der einzelnen benutzerdefinierten Format Bezeichner.If you do not use date or time separators in a custom format pattern, use the invariant culture for the provider parameter and the widest form of each custom format specifier. Wenn Sie z. b. Stunden im Muster angeben möchten, geben Sie die breitere Form "hh" anstelle des engeren Formulars "H" an.For example, if you want to specify hours in the pattern, specify the wider form, "HH", instead of the narrower form, "H".

Die bestimmten Datums-und Uhrzeit Symbole und-Zeichen folgen (z. b. die Namen der Wochentage in einer bestimmten Sprache) s , die in verwendet provider werden, werden durch den-Parameter definiert s , format ebenso wie das genaue Format von, wenn ein Standardformat ist. spezifiziererzeichenfolge.The particular date and time symbols and strings (such as the names of the days of the week in a particular language) used in s are defined by the provider parameter, as is the precise format of s if format is a standard format specifier string. Der provider -Parameter kann eine der folgenden sein:The provider parameter can be any of the following:

Wenn providerden Wert CultureInfo hat, wird das-Objekt verwendet, das der aktuellen Kultur entspricht. nullIf provider is null, the CultureInfo object that corresponds to the current culture is used.

Der styles -Parameter enthält mindestens einen Member DateTimeStyles der-Enumeration, der bestimmt, ob und wo Leerraum, format der nicht von s definiert wird, in angezeigt werden kann und das genaue Verhalten des Analyse Vorgangs steuert.The styles parameter includes one or more members of the DateTimeStyles enumeration that determine whether and where white space not defined by format can appear in s and that control the precise behavior of the parse operation. In der folgenden Tabelle wird beschrieben, wie sich DateTimeStyles jedes Member der-Enumeration TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) auf den Vorgang der-Methode auswirkt.The following table describes how each member of the DateTimeStyles enumeration affects the operation of the TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) method.

DateTimeStyles-MemberDateTimeStyles member BeschreibungDescription
AdjustToUniversal s Analysiert und konvertiert ggf. in UTC.Parses s and, if necessary, converts it to UTC. Wenn s einen Zeit Zonen Offset enthält oder wenn s keine Zeitzoneninformationen enthält, sondern styles das DateTimeStyles.AssumeLocal -Flag enthält, analysiert die-Methode die Zeichenfolge ToUniversalTime , und ruft auf DateTime , um den zurückgegebenen Wert in UTC zu konvertieren. , und legt die Kind -Eigenschaft DateTimeKind.Utcauf fest.If s includes a time zone offset, or if s contains no time zone information but styles includes the DateTimeStyles.AssumeLocal flag, the method parses the string, calls ToUniversalTime to convert the returned DateTime value to UTC, and sets the Kind property to DateTimeKind.Utc. Wenn s angibt, dass es sich um UTC handelt s , oder wenn keine Zeitzoneninformationen styles enthält, DateTimeStyles.AssumeUniversal sondern das-Flag enthält, analysiert die Methode die Zeichenfolge, führt keine Zeit Zonen DateTime Konvertierung für die zurückgegebene aus. , und legt die Kind -Eigenschaft auf DateTimeKind.Utcfest.If s indicates that it represents UTC, or if s does not contain time zone information but styles includes the DateTimeStyles.AssumeUniversal flag, the method parses the string, performs no time zone conversion on the returned DateTime value, and sets the Kind property to DateTimeKind.Utc. In allen anderen Fällen hat das Flag keine Auswirkung.In all other cases, the flag has no effect.
AllowInnerWhite Gibt an, dass der von nicht format definierte Leerraum zwischen einem einzelnen Date-oder Time-Element angezeigt werden kann.Specifies that white space not defined by format can appear between any individual date or time element.
AllowLeadingWhite Gibt an, dass Leerzeichen, format die nicht von definiert werden, sam Anfang von angezeigt werden können.Specifies that white space not defined by format can appear at the beginning of s.
AllowTrailingWhite Gibt an, dass Leerzeichen, format die nicht von definiert werden, sam Ende von angezeigt werden können.Specifies that white space not defined by format can appear at the end of s.
AllowWhiteSpaces Gibt an s , dass möglicherweise führende, innere und nachfolgende Leerzeichen enthält format, die nicht von definiert werden.Specifies that s may contain leading, inner, and trailing white spaces not defined by format.
AssumeLocal Gibt an, s dass, wenn keine Zeitzoneninformationen fehlt, angenommen wird, dass es sich um eine lokale Zeit handelt.Specifies that if s lacks any time zone information, it is assumed to represent a local time. Wenn das DateTimeStyles.AdjustToUniversal -Flag nicht vorhanden ist Kind , wird die- DateTime Eigenschaft des zurückgegebenen DateTimeKind.LocalWerts auf festgelegt.Unless the DateTimeStyles.AdjustToUniversal flag is present, the Kind property of the returned DateTime value is set to DateTimeKind.Local.
AssumeUniversal Gibt an, s dass, wenn keine Zeitzoneninformationen fehlt, angenommen wird, dass die UTC-Zeitangabe erfolgt.Specifies that if s lacks any time zone information, it is assumed to represent UTC. Wenn das DateTimeStyles.AdjustToUniversal -Flag nicht vorhanden ist, konvertiert die- DateTime Methode den zurückgegebenen Wert von UTC in die Kind lokale Zeit DateTimeKind.Localund legt seine-Eigenschaft auf fest.Unless the DateTimeStyles.AdjustToUniversal flag is present, the method converts the returned DateTime value from UTC to local time and sets its Kind property to DateTimeKind.Local.
NoCurrentDateDefault Wenn s Zeit ohne Datumsangaben enthält, wird das Datum des Rückgabewerts auf DateTime.MinValue.Datefestgelegt.If s contains time without date information, the date of the return value is set to DateTime.MinValue.Date.
None Der s -Parameter wird mit Standardwerten analysiert.The s parameter is parsed using default values. Es ist kein Leerraum zulässig, der format in vorhanden ist.No white space other than that present in format is allowed. Wenn s eine Datums Komponente fehlt, wird das Datum des zurück DateTime gegebenen Werts auf 1/1/0001 festgelegt.If s lacks a date component, the date of the returned DateTime value is set to 1/1/0001. Wenn s keine Zeitzoneninformationen enthält, wird Kind die-Eigenschaft des DateTime zurückgegebenen-Objekts DateTimeKind.Unspecifiedauf festgelegt.If s contains no time zone information, the Kind property of the returned DateTime object is set to DateTimeKind.Unspecified. Wenn Zeitzoneninformationen sin vorhanden sind, wird die Uhrzeit in die Ortszeit konvertiert, und die Kind -Eigenschaft des DateTime zurückgegebenen-Objekts DateTimeKind.Localwird auf festgelegt.If time zone information is present in s, the time is converted to local time and the Kind property of the returned DateTime object is set to DateTimeKind.Local.
RoundtripKind Bei Zeichen folgen, die Zeitzoneninformationen enthalten, versucht, die Konvertierung in DateTime einen-Wert Kind zu verhindern, DateTimeKind.Localdessen-Eigenschaft auf festgelegt ist.For strings that contain time zone information, tries to prevent the conversion to a DateTime value with its Kind property set to DateTimeKind.Local. Dieses Flag verhindert hauptsächlich die Konvertierung von UTC-Zeiten in lokale Uhrzeiten.This flag primarily prevents the conversion of UTC times to local times.

Hinweise für Aufrufer

In gibt die TryParseExact -Methode zurück false , wenn die zu erteilende Zeichenfolge eine Stunden Komponente und einen am/pm-Kenn Zeichner enthält, der nicht in der Vereinbarung ist. .NET Framework 4.NET Framework 4In the .NET Framework 4.NET Framework 4, the TryParseExact method returns false if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. .NET Framework 3,5.NET Framework 3.5 In und früheren Versionen wird der am/pm-Kenn Zeichner ignoriert.In the .NET Framework 3,5.NET Framework 3.5 and earlier versions, the AM/PM designator is ignored.

Siehe auch

Gilt für: