DateTimeOffset.TryParseExact DateTimeOffset.TryParseExact DateTimeOffset.TryParseExact DateTimeOffset.TryParseExact Method

Definition

Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe in die DateTimeOffset-Entsprechung.Converts the specified string representation of a date and time to its DateTimeOffset equivalent. Das Format der Zeichenfolgendarstellung muss einem angegebenen Format genau entsprechen.The format of the string representation must match a specified format exactly.

Überlädt

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

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formatarrays, der kulturspezifischen Formatierungsinformationen und des Stils in die DateTimeOffset-Entsprechung.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified array of formats, culture-specific format information, and style. Das Format der Zeichenfolgendarstellung muss einem der angegebenen Formate genau entsprechen.The format of the string representation must match one of the specified formats exactly.

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

Konvertiert die Darstellung einer Datums- und Uhrzeitangabe in einem Zeichenbereich unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in den entsprechenden DateTimeOffset.Converts the representation of a date and time in a character span to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Das Format der Darstellung von Datum und Uhrzeit muss dem angegebenen Format genau entsprechen.The format of the date and time representation must match the specified format exactly.

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

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in die entsprechende DateTimeOffset.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Das Format der Zeichenfolgenentsprechung muss dem angegebenen Format genau entsprechen.The format of the string representation must match the specified format exactly.

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

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formatarrays, der kulturspezifischen Formatierungsinformationen und des Stils in die DateTimeOffset-Entsprechung.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified array of formats, culture-specific format information, and style. Das Format der Zeichenfolgendarstellung muss einem der angegebenen Formate genau entsprechen.The format of the string representation must match one of the specified formats exactly.

public:
 static bool TryParseExact(System::String ^ input, cli::array <System::String ^> ^ formats, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParseExact (string input, string[] formats, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
static member TryParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool
Public Shared Function TryParseExact (input As String, formats As String(), formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean

Parameter

input
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, das die erwarteten Formate von input definiert.An array that defines the expected formats of input.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

styles
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

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

result
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Die Methode gibt bei erfolgreicher Konvertierung den DateTimeOffset zurück, der dem Datum und der Uhrzeit von input entspricht, oder MinValue, wenn die Konvertierung nicht durchgeführt werden konnte.When the method returns, contains the DateTimeOffset equivalent to the date and time of input, if the conversion succeeded, or MinValue, if the conversion failed. Die Konvertierung kann nicht durchgeführt werden, wenn input keine gültige Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe enthält oder wenn die enthaltene Datums- und Uhrzeitangabe nicht das von format definierte Format aufweist oder wenn formats den Wert null hat.The conversion fails if the input does not contain a valid string representation of a date and time, or does not contain the date and time in the expected format defined by format, or if formats is null. Dieser Parameter wird nicht initialisiert übergeben.This parameter is passed uninitialized.

Gibt zurück

true, wenn der input-Parameter erfolgreich konvertiert wird, andernfalls false.true if the input parameter is successfully converted; otherwise, false.

Ausnahmen

styles beinhaltet einen nicht definierten DateTimeStyles-Wert.styles includes an undefined DateTimeStyles value.

- oder --or- NoCurrentDateDefault wird nicht unterstützt.NoCurrentDateDefault is not supported.

- oder --or- styles beinhaltet sich gegenseitig ausschließende DateTimeStyles-Werte.styles includes mutually exclusive DateTimeStyles values.

Beispiele

Im folgenden Beispiel werden mehrere Eingabeformate für die Zeichen folgen Darstellung eines Datums-, Uhrzeit-und Offset Werts definiert, und anschließend wird die vom Benutzer eingegebene Zeichenfolge TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) an die-Methode weitergeleitet.The following example defines multiple input formats for the string representation of a date and time and offset value, and then passes the string that is entered by the user to the TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) method.

 TextReader conIn = Console.In;
 TextWriter conOut = Console.Out;
 int tries = 0;
 string input = String.Empty;

 string[] formats = new string[] {"M/dd/yyyy HH:m zzz", "MM/dd/yyyy HH:m zzz", 
                                  "M/d/yyyy HH:m zzz", "MM/d/yyyy HH:m zzz", 
                                  "M/dd/yy HH:m zzz", "MM/dd/yy HH:m zzz", 
                                  "M/d/yy HH:m zzz", "MM/d/yy HH:m zzz",                                 
                                  "M/dd/yyyy H:m zzz", "MM/dd/yyyy H:m zzz", 
                                  "M/d/yyyy H:m zzz", "MM/d/yyyy H:m zzz", 
                                  "M/dd/yy H:m zzz", "MM/dd/yy H:m zzz", 
                                  "M/d/yy H:m zzz", "MM/d/yy H:m zzz",                               
                                  "M/dd/yyyy HH:mm zzz", "MM/dd/yyyy HH:mm zzz", 
                                  "M/d/yyyy HH:mm zzz", "MM/d/yyyy HH:mm zzz", 
                                  "M/dd/yy HH:mm zzz", "MM/dd/yy HH:mm zzz", 
                                  "M/d/yy HH:mm zzz", "MM/d/yy HH:mm zzz",                                 
                                  "M/dd/yyyy H:mm zzz", "MM/dd/yyyy H:mm zzz", 
                                  "M/d/yyyy H:mm zzz", "MM/d/yyyy H:mm zzz", 
                                  "M/dd/yy H:mm zzz", "MM/dd/yy H:mm zzz", 
                                  "M/d/yy H:mm zzz", "MM/d/yy H:mm zzz"};   
 IFormatProvider provider = CultureInfo.InvariantCulture.DateTimeFormat;
 DateTimeOffset result;

 do {
    conOut.WriteLine("Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),");
    conOut.Write("Then press Enter: ");
    input = conIn.ReadLine();
    conOut.WriteLine(); 
    if (DateTimeOffset.TryParseExact(input, formats, provider, 
                                    DateTimeStyles.AllowWhiteSpaces, 
                                    out result))
    {                                          
       break;
    }
    else
    {  
       Console.WriteLine("Unable to parse {0}.", input);      
       tries++;
    }
 } while (tries < 3);
 if (tries >= 3)
    Console.WriteLine("Exiting application without parsing {0}", input);
 else
    Console.WriteLine("{0} was converted to {1}", input, result.ToString());                                                     
 // Some successful sample interactions with the user might appear as follows:
 //    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
 //    Then press Enter: 12/08/2007 6:54 -6:00
 //    
 //    12/08/2007 6:54 -6:00 was converted to 12/8/2007 6:54:00 AM -06:00         
 //    
 //    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
 //    Then press Enter: 12/8/2007 06:54 -06:00
 //    
 //    12/8/2007 06:54 -06:00 was converted to 12/8/2007 6:54:00 AM -06:00
 //    
 //    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
 //    Then press Enter: 12/5/07 6:54 -6:00
 //    
 //    12/5/07 6:54 -6:00 was converted to 12/5/2007 6:54:00 AM -06:00 
 Dim conIn As TextReader = Console.In
 Dim conOut As TextWriter = Console.Out
 Dim tries As Integer = 0
 Dim input As String = String.Empty
 Dim formats() As String = {"M/dd/yyyy HH:m zzz", "MM/dd/yyyy HH:m zzz", _
                            "M/d/yyyy HH:m zzz", "MM/d/yyyy HH:m zzz", _
                            "M/dd/yy HH:m zzz", "MM/dd/yy HH:m zzz", _
                            "M/d/yy HH:m zzz", "MM/d/yy HH:m zzz", _                                 
                            "M/dd/yyyy H:m zzz", "MM/dd/yyyy H:m zzz", _
                            "M/d/yyyy H:m zzz", "MM/d/yyyy H:m zzz", _
                            "M/dd/yy H:m zzz", "MM/dd/yy H:m zzz", _
                            "M/d/yy H:m zzz", "MM/d/yy H:m zzz", _                               
                            "M/dd/yyyy HH:mm zzz", "MM/dd/yyyy HH:mm zzz", _
                            "M/d/yyyy HH:mm zzz", "MM/d/yyyy HH:mm zzz", _
                            "M/dd/yy HH:mm zzz", "MM/dd/yy HH:mm zzz", _
                            "M/d/yy HH:mm zzz", "MM/d/yy HH:mm zzz", _                                 
                            "M/dd/yyyy H:mm zzz", "MM/dd/yyyy H:mm zzz", _
                            "M/d/yyyy H:mm zzz", "MM/d/yyyy H:mm zzz", _
                            "M/dd/yy H:mm zzz", "MM/dd/yy H:mm zzz", _
                            "M/d/yy H:mm zzz", "MM/d/yy H:mm zzz"}   
 Dim provider As IFormatProvider = CultureInfo.InvariantCulture.DateTimeFormat
 Dim result As DateTimeOffset

 Do 
    conOut.WriteLine("Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),")
    conOut.Write("Then press Enter: ")
    input = conIn.ReadLine()
    conOut.WriteLine() 
    If DateTimeOffset.TryParseExact(input, formats, provider, _
                                    DateTimeStyles.AllowWhiteSpaces, _
                                    result) Then
       Exit Do
    Else
       Console.WriteLine("Unable to parse {0}.", input)      
       tries += 1
    End If
 Loop While tries < 3
 If tries >= 3 Then
    Console.WriteLine("Exiting application without parsing {0}", input)
 Else
    Console.WriteLine("{0} was converted to {1}", input, result.ToString())                                                     
 End If 
 ' Some successful sample interactions with the user might appear as follows:
 '    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
 '    Then press Enter: 12/08/2007 6:54 -6:00
 '    
 '    12/08/2007 6:54 -6:00 was converted to 12/8/2007 6:54:00 AM -06:00         
 '    
 '    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
 '    Then press Enter: 12/8/2007 06:54 -06:00
 '    
 '    12/8/2007 06:54 -06:00 was converted to 12/8/2007 6:54:00 AM -06:00
 '    
 '    Enter a date, time, and offset (MM/DD/YYYY HH:MM +/-HH:MM),
 '    Then press Enter: 12/5/07 6:54 -6:00
 '    
 '    12/5/07 6:54 -6:00 was converted to 12/5/2007 6:54:00 AM -06:00 

Hinweise

Die TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) -Methode analysiert die Zeichen folgen Darstellung eines Datums, das mit einem der dem formats Array zugewiesenen Muster übereinstimmt.The TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) method parses the string representation of a date that matches any one of the patterns assigned to the formats array. Wenn die input Zeichenfolge nicht mit einem dieser Muster mit Variationen identisch ist, die durch den styles -Parameter definiert sind, schlägt der Verarbeitungsvorgang fehl, falseund die-Methode gibt zurück.If the input string does not match any one of these patterns with any variations defined by the styles parameter, the parsing operation fails and the method returns false. Abgesehen vom Vergleich input mit mehreren Zeichen folgen, die Format Bearbeiter enthalten, verhält sich diese Überladung DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) identisch mit der-Methode.Aside from comparing input to multiple strings that contain format specifiers, this overload behaves identically to the DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method.

Der formats -Parameter ist ein Zeichen folgen Array, dessen Elemente entweder einen einzelnen Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthalten, die inputdas mögliche Muster von definieren.The formats parameter is a string array whose elements contain either a single standard format specifier or one or more custom format specifiers that define the possible pattern of input. Details zu gültigen Formatierungscodes finden Sie unter Standard Format Zeichenfolgen für Datum und Uhrzeit und benutzerdefinierte Format Zeichenfolgen für Datum und Uhrzeit.For details about valid formatting codes, see Standard Date and Time Format Strings and Custom Date and Time Format Strings. Wenn das übereinstimmende formats Element in zdie zzbenutzerdefinierten zzz Format Bearbeiter, oder enthält, um anzugeben, dass ein Offset inputin vorhanden sein muss, muss dieser Offset entweder ein negatives oder ein positives Vorzeichen enthalten.If the matched element in formats includes the z, zz, or zzz custom format specifiers to indicate that an offset must be present in input, that offset must include either a negative sign or a positive sign. Wenn das Vorzeichen fehlt, schlägt der Analyse Vorgang fehl, und die Methode gibt falsezurück.If the sign is missing, the parse operation fails and the method returns false.

Wichtig

Die Verwendung formats des-Parameters dieser Überladung zum Angeben mehrerer Formate kann die Frustration vieler Benutzer beeinträchtigen, wenn Sie Datumsangaben und Uhrzeiten eingeben.Using the formats parameter of this overload to specify multiple formats can help reduce the frustration many users experience when they enter dates and times. Die Möglichkeit, mehrere Eingabemuster zu definieren, ermöglicht es einer Anwendung, Datums-und Uhrzeit Darstellungen zu verarbeiten, bei denen führende Nullen in Monaten, Tagen, Stunden, Minuten und Sekunden enthalten sein können oder fehlen.In particular, the ability to define multiple input patterns enables an application to handle date and time representations that can either include or lack leading zeros in months, days, hours, minutes, and seconds. Dies wird in diesem Beispiel veranschaulicht.The example provides an illustration of this.

Wenn das übereinstimmende formats Element in input erfordert, dass ein Datum, aber keine Uhrzeit enthalten DateTimeOffset ist, wird dem resultierenden Objekt eine Uhrzeit von Mitternacht (0:00:00) zugewiesen.If the matched element in formats requires that input contain a date but not a time, the resulting DateTimeOffset object is assigned a time of midnight (0:00:00). Wenn das übereinstimmende formats Element in erfordert, dass die Eingabe eine Uhrzeit, aber kein Datum DateTimeOffset enthält, wird dem resultierenden Objekt das aktuelle Datum auf dem lokalen System zugewiesen.If the matched element in formats requires that input contain a time but not a date, the resulting DateTimeOffset object is assigned the current date on the local system. Wenn das übereinstimmende formats Element in nicht erfordert input , dass einen Offset enthalten, hängt der Offset DateTimeOffset des resultierenden Objekts vom Wert des styles -Parameters ab.If the matched element in formats does not require that input contain an offset, the offset of the resulting DateTimeOffset object depends on the value of the styles parameter. Wenn styles den AssumeLocalWert enthält, wird der Offset der lokalen Zeitzone dem DateTimeOffset -Objekt zugewiesen.If styles includes AssumeLocal, the offset of the local time zone is assigned to the DateTimeOffset object. Wenn styles den AssumeUniversalWert enthält, wird der koordinierte Weltzeit (UTC) oder + 00:00 dem- DateTimeOffset Objekt zugewiesen.If styles includes AssumeUniversal, the Coordinated Universal Time (UTC) offset, or +00:00, is assigned to the DateTimeOffset object. Wenn kein Wert angegeben ist, wird der Offset der lokalen Zeitzone verwendet.If neither value is specified, the offset of the local time zone is used.

Die bestimmten Datums-und Uhrzeit Symbole und Zeichen folgen input , die in verwendet formatProvider werden, werden durch den-Parameter definiert.The particular date and time symbols and strings used in input are defined by the formatProvider parameter. Das gleiche gilt für das genaue Muster von input , wenn das übereinstimmende Element von formats eine standardformatspezifiziererzeichenfolge ist.The same is true for the precise pattern of input if the matching element of formats is a standard format specifier string. Der formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

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

Der styles -Parameter definiert, ob Leerzeichen in der Eingabe Zeichenfolge zulässig sind, gibt an, wie Zeichen folgen ohne explizite Offset Komponente analysiert werden, und unterstützt die UTC-Konvertierung als Teil des Analyse Vorgangs.The styles parameter defines whether white space is permitted in the input string, indicates how strings without an explicit offset component are parsed, and supports UTC conversion as part of the parsing operation. Alle Member der DateTimeStyles -Enumeration werden außer NoCurrentDateDefaultunterstützt.All members of the DateTimeStyles enumeration are supported except NoCurrentDateDefault. In der folgenden Tabelle sind die Auswirkungen der einzelnen unterstützten Member aufgeführt.The following table lists the effect of each supported member.

DateTimeStyles -MemberDateTimeStyles member VerhaltenBehavior
AdjustToUniversal input Analysiert und konvertiert ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht dem Initialisieren einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime -Methode des zurück DateTimeOffset gegebenen-Objekts.It is equivalent to parsing a string, and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AssumeLocal Wenn das übereinstimmende formats Element in nicht erfordert input , dass einen Offset-Wert enthält DateTimeOffset , wird dem zurückgegebenen Objekt der Offset der lokalen Zeitzone zugewiesen.If the matched element in formats does not require that input contain an offset value, the returned DateTimeOffset object is given the offset of the local time zone. Dies ist der Standardwert.This is the default value.
AssumeUniversal Wenn das übereinstimmende formats Element in nicht erfordert input , dass einen Offset-Wert enthält DateTimeOffset , erhält das zurückgegebene Objekt den UTC-Offset (+ 00:00).If the matched element in formats does not require that input contain an offset value, the returned DateTimeOffset object is given the UTC offset (+00:00).
AllowInnerWhite Ermöglicht input das Einschließen von inneren Leerraum, der nicht von den formatsElementen in angegeben wird.Allows input to include inner white space not specified by the elements in formats. Zusätzliche Leerzeichen können zwischen Datums-und Uhrzeit Komponenten und innerhalb einzelner Komponenten (mit Ausnahme des Offsets) angezeigt werden und werden bei der Verarbeitung der Zeichenfolge ignoriert.Extra white space can appear between date and time components and within individual components (except for the offset) and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, die nicht von formatsden Elementen in angegeben werden.Allows input to include leading spaces not specified by the elements in formats. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowTrailingWhite Ermöglicht input das Einschließen von nachfolgenden Leerzeichen, die nicht formatsvon den Elementen in angegeben werden.Allows input to include trailing spaces not specified by the elements in formats. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowWhiteSpaces Ermöglicht input das Einschließen von führenden, nachfolgenden und inneren Leerzeichen, die nicht von formatsden Elementen in angegeben werden.Allows input to include leading, trailing, and inner spaces not specified by the elements in formats. Alle zusätzlichen Leerzeichen, die nicht im übereinstimmenden Element in formats angegeben sind, werden beim Auswerten der Zeichenfolge ignoriert.All extra white-space characters not specified in the matched element in formats are ignored when parsing the string.
None Gibt an, dass zusätzliche Leerzeichen in inputnicht zulässig sind.Indicates that additional white space is not permitted in input. Leerraum muss genau so angezeigt werden, wie in einem bestimmten formats Element in angegeben, damit eine erfolgreiche Übereinstimmung auftritt.White space must appear exactly as specified in a particular element in formats for a successful match to occur. Dies ist das Standardverhalten.This is the default behavior.
RoundtripKind Hat keine Auswirkung, da DateTimeOffset die-Struktur keine- Kind Eigenschaft enthält.Has no effect because the DateTimeOffset structure does not include a Kind property.

Hinweise für Aufrufer

In gibt die zurück TryParseExact .NET Framework 4.NET Framework 4 false , wenn die zu erteilende Zeichenfolge eine Stunden Komponente und einen am/pm-Kenn Zeichner enthält, der nicht in der Vereinbarung ist.In the .NET Framework 4.NET Framework 4, the TryParseExact 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.

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

Konvertiert die Darstellung einer Datums- und Uhrzeitangabe in einem Zeichenbereich unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in den entsprechenden DateTimeOffset.Converts the representation of a date and time in a character span to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Das Format der Darstellung von Datum und Uhrzeit muss dem angegebenen Format genau entsprechen.The format of the date and time representation must match the specified format exactly.

public:
 static bool TryParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool
Public Shared Function TryParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean

Parameter

input
ReadOnlySpan<Char>

Ein Zeichenbereich, der die Darstellung der zu konvertierenden Datums- und Zeitangabe enthält.A character span that contains the representation of a date and time to convert.

format
ReadOnlySpan<Char>

Ein Formatbezeichner, der das erforderliche Format von input definiert.A format specifier that defines the required format of input.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

styles
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

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

result
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Die Methode gibt bei erfolgreicher Konvertierung den DateTimeOffset-Wert zurück, der dem Datum und der Uhrzeit von input entspricht, oder MinValue, wenn die Konvertierung nicht durchgeführt werden konnte.When the method returns, contains the DateTimeOffset equivalent to the date and time of input, if the conversion succeeded, or MinValue if the conversion failed. Die Konvertierung schlägt fehl, wennThe conversion fails if the

Gibt zurück

true, wenn der input-Parameter erfolgreich konvertiert wird, andernfalls false.true if the input parameter is successfully converted; otherwise, false.

Ausnahmen

styles beinhaltet einen nicht definierten DateTimeStyles-Wert.styles includes an undefined DateTimeStyles value.
oder NoCurrentDateDefault wird nicht unterstützt.-or- NoCurrentDateDefault is not supported.
oder styles enthält sich gegenseitig ausschließende DateTimeStyles-Werte.-or- styles includes mutually exclusive DateTimeStyles values.

Hinweise

Diese Überladung ähnelt der DateTimeOffset.ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) -Methode, mit der Ausnahme, dass diese Methode keine Ausnahme auslöst, wenn bei der Konvertierung ein Fehler auftritt.This overload is like the DateTimeOffset.ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) method, except that this method does not throw an exception if the conversion fails. Es analysiert die Darstellung eines Datums und einer Uhrzeit, die exakt mit dem durch den format -Parameter angegebenen Muster übereinstimmen müssen.It parses the representation of a date and time that must exactly match the pattern specified by the format parameter. Wenn input nicht mit diesem Muster identisch ist und einige mögliche Variationen im Leerraum durch den styles -Parameter definiert sind, schlägt der Verarbeitungsvorgang fehl, und falsedie-Methode gibt zurück.If input does not match this pattern, with some possible variations in white space defined by the styles parameter, the parsing operation fails and the method returns false.

Der format -Parameter ist eine Zeichen Spanne, die entweder einen einzelnen Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthält, die das inputerforderliche Muster von definieren.The format parameter is a character span that contains either a single standard format specifier or one or more custom format specifiers that define the required pattern of input. Details zu gültigen Formatierungscodes finden Sie unter Standard Format Zeichenfolgen für Datum und Uhrzeit und benutzerdefinierte Format Zeichenfolgen für Datum und Uhrzeit.For details about valid formatting codes, see Standard Date and Time Format Strings and Custom Date and Time Format Strings. Wenn format zzdie zbenutzerdefinierten Format Bearbeiter, oder zzz enthält, um anzugeben, dass ein Offset in inputvorhanden sein muss, muss dieser Offset entweder ein negatives oder ein positives Vorzeichen enthalten.If format includes the z, zz, or zzz custom format specifiers to indicate that an offset must be present in input, that offset must include either a negative sign or a positive sign. Wenn das Vorzeichen fehlt, schlägt der Verarbeitungsvorgang fehl, und die Methode gibt falsezurück.If the sign is missing, the parsing operation fails and the method returns false.

Wenn format erfordert, input dass ein Datum, aber keine Uhrzeit enthält, wird DateTimeOffset dem resultierenden Objekt eine Uhrzeit von Mitternacht (0:00:00) zugewiesen.If format requires that input contain a date but not a time, the resulting DateTimeOffset object is assigned a time of midnight (0:00:00). Wenn format erfordert, input dass eine Uhrzeit, aber kein Datum enthält, wird DateTimeOffset dem resultierenden Objekt das aktuelle Datum auf dem lokalen System zugewiesen.If format requires that input contain a time but not a date, the resulting DateTimeOffset object is assigned the current date on the local system. Wenn format nicht erfordert, dass input einen Offset enthalten, hängt der Offset des resultierenden DateTimeOffset Objekts vom Wert des styles -Parameters ab.If format does not require that input contain an offset, the offset of the resulting DateTimeOffset object depends on the value of the styles parameter. Wenn styles den AssumeLocalWert enthält, wird der Offset der lokalen Zeitzone dem DateTimeOffset -Objekt zugewiesen.If styles includes AssumeLocal, the offset of the local time zone is assigned to the DateTimeOffset object. Wenn styles den AssumeUniversalWert enthält, wird der koordinierte Weltzeit (UTC) oder + 00:00 dem- DateTimeOffset Objekt zugewiesen.If styles includes AssumeUniversal, the Coordinated Universal Time (UTC) offset, or +00:00, is assigned to the DateTimeOffset object. Wenn kein Wert angegeben ist, wird der Offset der lokalen Zeitzone verwendet.If neither value is specified, the offset of the local time zone is used.

Die bestimmten Datums-und Uhrzeit Symbole und Zeichen folgen input , die in verwendet formatProvider werden, werden durch den-Parameter definiert.The particular date and time symbols and strings used in input are defined by the formatProvider parameter. Das gleiche gilt für das genaue Muster von input , wenn format eine Standardformat Bezeichner-Zeichenfolge ist.The same is true for the precise pattern of input if format is a standard format specifier string. Der formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

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

Der styles -Parameter definiert, ob Leerzeichen in der Eingabe Zeichenfolge zulässig sind, gibt an, wie Zeichen folgen ohne explizite Offset Komponente analysiert werden, und unterstützt die UTC-Konvertierung als Teil des Analyse Vorgangs.The styles parameter defines whether white space is allowed in the input string, indicates how strings without an explicit offset component are parsed, and supports UTC conversion as part of the parsing operation. Alle Member der DateTimeStyles -Enumeration werden außer NoCurrentDateDefaultunterstützt.All members of the DateTimeStyles enumeration are supported except NoCurrentDateDefault. In der folgenden Tabelle sind die Auswirkungen der einzelnen unterstützten Member aufgeführt.The following table lists the effect of each supported member.

DateTimeStyles -MemberDateTimeStyles member VerhaltenBehavior
AdjustToUniversal input Analysiert und konvertiert ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht der Verarbeitung einer Datums-und Uhrzeit Darstellung und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime -Methode des zurückgegebenen DateTimeOffset -Objekts.It is equivalent to parsing a date and time representation, and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AssumeLocal Wenn format nicht erfordert, dass input einen Offset-Wert enthält, wird DateTimeOffset dem zurückgegebenen Objekt der Offset der lokalen Zeitzone zugewiesen.If format does not require that input contain an offset value, the returned DateTimeOffset object is given the offset of the local time zone. Dies ist das Standardverhalten.This is the default behavior.
AssumeUniversal Wenn format nicht erfordert, dass input einen Offset-Wert enthält, erhält DateTimeOffset das zurückgegebene Objekt den UTC-Offset (+ 00:00).If format does not require that input contain an offset value, the returned DateTimeOffset object is given the UTC offset (+00:00).
AllowInnerWhite Ermöglicht input das Einschließen von inneren Leerraum, der nicht durch das Format angegeben wird.Allows input to include inner white space not specified by format. Zusätzliche Leerräume können zwischen Datums-und Uhrzeit Komponenten und innerhalb einzelner Komponenten, außer dem Offset, angezeigt werden und werden bei der Verarbeitung der Zeichenfolge ignoriert.Extra white space can appear between date and time components and within individual components, other than the offset, and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, formatdie nicht von angegeben werden.Allows input to include leading spaces not specified by format. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowTrailingWhite Ermöglicht input das Einschließen von nachfolgenden Leerzeichen format, die nicht von angegeben werdenAllows input to include trailing spaces not specified by format. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowWhiteSpaces Ermöglicht input das Einschließen von führenden, nachfolgenden und inneren Leerzeichen, formatdie nicht von angegeben werden.Allows input to include leading, trailing, and inner spaces not specified by format. Alle zusätzlichen Leerzeichen, die nicht in format angegeben sind, werden beim Auswerten der Zeichenfolge ignoriert.All extra white-space characters not specified in format are ignored when parsing the string.
None Gibt an, dass zusätzliche Leerzeichen in inputnicht zulässig sind.Indicates that additional white space is not permitted in input. Leerraum muss genau wie in formatangegeben angezeigt werden.White space must appear exactly as specified in format. Dies ist das Standardverhalten.This is the default behavior.
RoundtripKind Hat keine Auswirkung, da die DateTimeOffset -Struktur keine- Kind Eigenschaft enthält.Has no effect, because the DateTimeOffset structure does not include a Kind property.

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

public:
 static bool TryParseExact(ReadOnlySpan<char> input, cli::array <System::String ^> ^ formats, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParseExact (ReadOnlySpan<char> input, string[] formats, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
static member TryParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool
Public Shared Function TryParseExact (input As ReadOnlySpan(Of Char), formats As String(), formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean

Parameter

formats
String[]

Gibt zurück

Ausnahmen

styles beinhaltet einen nicht definierten DateTimeStyles-Wert.styles includes an undefined DateTimeStyles value.
oder NoCurrentDateDefault wird nicht unterstützt.-or- NoCurrentDateDefault is not supported.
oder styles enthält sich gegenseitig ausschließende DateTimeStyles-Werte.-or- styles includes mutually exclusive DateTimeStyles values.

Hinweise

Diese Methode analysiert die Zeichen folgen Darstellung eines Datums, das mit einem der Muster übereinstimmt, die dem formats Array zugewiesen sind.This method parses the string representation of a date that matches any one of the patterns assigned to the formats array. Wenn input keines dieser Muster mit den styles vom-Parameter definierten Variationen erfüllt, schlägt der Verarbeitungsvorgang fehl, und die-Methode gibt zurück false.If input does not match any one of these patterns with any variations defined by the styles parameter, the parsing operation fails and the method returns false. Abgesehen vom Vergleich input mit mehreren Zeichen folgen, die Format Bearbeiter enthalten, verhält sich diese Überladung DateTimeOffset.ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) identisch mit der-Methode.Aside from comparing input to multiple strings that contain format specifiers, this overload behaves identically to the DateTimeOffset.ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) method.

Der formats -Parameter ist ein Zeichen folgen Array, dessen Elemente entweder einen einzelnen Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthalten, die inputdas mögliche Muster von definieren.The formats parameter is a string array whose elements contain either a single standard format specifier or one or more custom format specifiers that define the possible pattern of input. Details zu gültigen Formatierungscodes finden Sie unter Standard Format Zeichenfolgen für Datum und Uhrzeit und benutzerdefinierte Format Zeichenfolgen für Datum und Uhrzeit.For details about valid formatting codes, see Standard Date and Time Format Strings and Custom Date and Time Format Strings. Wenn das übereinstimmende formats Element in zdie zzbenutzerdefinierten zzz Format Bearbeiter, oder enthält, um anzugeben, dass ein Offset inputin vorhanden sein muss, muss dieser Offset entweder ein negatives oder ein positives Vorzeichen enthalten.If the matched element in formats includes the z, zz, or zzz custom format specifiers to indicate that an offset must be present in input, that offset must include either a negative sign or a positive sign. Wenn das Vorzeichen fehlt, schlägt der Analyse Vorgang fehl, und die Methode gibt falsezurück.If the sign is missing, the parse operation fails and the method returns false.

Wichtig

Die Verwendung formats des-Parameters dieser Überladung zum Angeben mehrerer Formate kann die Frustration vieler Benutzer beeinträchtigen, wenn Sie Datumsangaben und Uhrzeiten eingeben.Using the formats parameter of this overload to specify multiple formats can help reduce the frustration many users experience when they enter dates and times. Die Möglichkeit, mehrere Eingabemuster zu definieren, ermöglicht es einer Anwendung, Datums-und Uhrzeit Darstellungen zu verarbeiten, bei denen führende Nullen in Monaten, Tagen, Stunden, Minuten und Sekunden enthalten sein können oder fehlen.In particular, the ability to define multiple input patterns enables an application to handle date and time representations that can either include or lack leading zeros in months, days, hours, minutes, and seconds. Dies wird in diesem Beispiel veranschaulicht.The example provides an illustration of this.

Wenn das übereinstimmende formats Element in input erfordert, dass ein Datum, aber keine Uhrzeit enthalten DateTimeOffset ist, wird dem resultierenden Objekt eine Uhrzeit von Mitternacht (0:00:00) zugewiesen.If the matched element in formats requires that input contain a date but not a time, the resulting DateTimeOffset object is assigned a time of midnight (0:00:00). Wenn das übereinstimmende formats Element in erfordert, dass die Eingabe eine Uhrzeit, aber kein Datum DateTimeOffset enthält, wird dem resultierenden Objekt das aktuelle Datum auf dem lokalen System zugewiesen.If the matched element in formats requires that input contain a time but not a date, the resulting DateTimeOffset object is assigned the current date on the local system. Wenn das übereinstimmende formats Element in nicht erfordert input , dass einen Offset enthalten, hängt der Offset DateTimeOffset des resultierenden Objekts vom Wert des styles -Parameters ab.If the matched element in formats does not require that input contain an offset, the offset of the resulting DateTimeOffset object depends on the value of the styles parameter. Wenn styles den DateTimeStyles.AssumeLocalWert enthält, wird der Offset der lokalen Zeitzone dem DateTimeOffset -Objekt zugewiesen.If styles includes DateTimeStyles.AssumeLocal, the offset of the local time zone is assigned to the DateTimeOffset object. Wenn styles den DateTimeStyles.AssumeUniversalWert enthält, wird der koordinierte Weltzeit (UTC) oder + 00:00 dem- DateTimeOffset Objekt zugewiesen.If styles includes DateTimeStyles.AssumeUniversal, the Coordinated Universal Time (UTC) offset, or +00:00, is assigned to the DateTimeOffset object. Wenn kein Wert angegeben ist, wird der Offset der lokalen Zeitzone verwendet.If neither value is specified, the offset of the local time zone is used.

Die bestimmten Datums-und Uhrzeit Symbole, input die in verwendet werden formatProvider , werden durch den-Parameter definiert.The particular date and time symbols used in input are defined by the formatProvider parameter. Das gleiche gilt für das genaue Muster von input , wenn das übereinstimmende Element von formats eine standardformatspezifiziererzeichenfolge ist.The same is true for the precise pattern of input if the matching element of formats is a standard format specifier string. Der formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

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

Der styles -Parameter definiert, ob Leerzeichen in der Eingabe Zeichenfolge zulässig sind, gibt an, wie Zeichen folgen ohne explizite Offset Komponente analysiert werden, und unterstützt die UTC-Konvertierung als Teil des Analyse Vorgangs.The styles parameter defines whether white space is permitted in the input string, indicates how strings without an explicit offset component are parsed, and supports UTC conversion as part of the parsing operation. Alle Member der DateTimeStyles -Enumeration werden außer NoCurrentDateDefaultunterstützt.All members of the DateTimeStyles enumeration are supported except NoCurrentDateDefault. In der folgenden Tabelle sind die Auswirkungen der einzelnen unterstützten Member aufgeführt.The following table lists the effect of each supported member.

DateTimeStyles -MemberDateTimeStyles member VerhaltenBehavior
AdjustToUniversal input Analysiert und konvertiert ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht dem Initialisieren einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime -Methode des zurück DateTimeOffset gegebenen-Objekts.It is equivalent to parsing a string, and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AssumeLocal Wenn das übereinstimmende formats Element in nicht erfordert input , dass einen Offset-Wert enthält DateTimeOffset , wird dem zurückgegebenen Objekt der Offset der lokalen Zeitzone zugewiesen.If the matched element in formats does not require that input contain an offset value, the returned DateTimeOffset object is given the offset of the local time zone. Dies ist der Standardwert.This is the default value.
AssumeUniversal Wenn das übereinstimmende formats Element in nicht erfordert input , dass einen Offset-Wert enthält DateTimeOffset , erhält das zurückgegebene Objekt den UTC-Offset (+ 00:00).If the matched element in formats does not require that input contain an offset value, the returned DateTimeOffset object is given the UTC offset (+00:00).
AllowInnerWhite Ermöglicht input das Einschließen von inneren Leerraum, der nicht von den formatsElementen in angegeben wird.Allows input to include inner white space not specified by the elements in formats. Zusätzliche Leerzeichen können zwischen Datums-und Uhrzeit Komponenten und innerhalb einzelner Komponenten (mit Ausnahme des Offsets) angezeigt werden und werden bei der Verarbeitung der Zeichenfolge ignoriert.Extra white space can appear between date and time components and within individual components (except for the offset) and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, die nicht von formatsden Elementen in angegeben werden.Allows input to include leading spaces not specified by the elements in formats. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowTrailingWhite Ermöglicht input das Einschließen von nachfolgenden Leerzeichen, die nicht formatsvon den Elementen in angegeben werden.Allows input to include trailing spaces not specified by the elements in formats. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowWhiteSpaces Ermöglicht input das Einschließen von führenden, nachfolgenden und inneren Leerzeichen, die nicht von formatsden Elementen in angegeben werden.Allows input to include leading, trailing, and inner spaces not specified by the elements in formats. Alle zusätzlichen Leerzeichen, die nicht im übereinstimmenden Element in formats angegeben sind, werden beim Auswerten der Zeichenfolge ignoriert.All extra white-space characters not specified in the matched element in formats are ignored when parsing the string.
None Gibt an, dass zusätzliche Leerzeichen in inputnicht zulässig sind.Indicates that additional white space is not permitted in input. Leerraum muss genau so angezeigt werden, wie in einem bestimmten formats Element in angegeben, damit eine erfolgreiche Übereinstimmung auftritt.White space must appear exactly as specified in a particular element in formats for a successful match to occur. Dies ist das Standardverhalten.This is the default behavior.
RoundtripKind Hat keine Auswirkung, da DateTimeOffset die-Struktur keine- Kind Eigenschaft enthält.Has no effect because the DateTimeOffset structure does not include a Kind property.

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in die entsprechende DateTimeOffset.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Das Format der Zeichenfolgenentsprechung muss dem angegebenen Format genau entsprechen.The format of the string representation must match the specified format exactly.

public:
 static bool TryParseExact(System::String ^ input, System::String ^ format, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParseExact (string input, string format, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
static member TryParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool
Public Shared Function TryParseExact (input As String, format As String, formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean

Parameter

input
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.

format
String String String String

Ein Formatbezeichner, der das erforderliche Format von input definiert.A format specifier that defines the required format of input.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

styles
DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles

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

result
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Die Methode gibt bei erfolgreicher Konvertierung den DateTimeOffset zurück, der dem Datum und der Uhrzeit von input entspricht, oder MinValue, wenn die Konvertierung nicht durchgeführt werden konnte.When the method returns, contains the DateTimeOffset equivalent to the date and time of input, if the conversion succeeded, or MinValue, if the conversion failed. Die Konvertierung kann nicht durchgeführt werden, wenn der input-Parameter den Wert null hat oder keine gültige Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe im von format und provider definierten erwarteten Format enthält.The conversion fails if the input parameter is null, or does not contain a valid string representation of a date and time in the expected format defined by format and provider. Dieser Parameter wird nicht initialisiert übergeben.This parameter is passed uninitialized.

Gibt zurück

true, wenn der input-Parameter erfolgreich konvertiert wird, andernfalls false.true if the input parameter is successfully converted; otherwise, false.

Ausnahmen

styles beinhaltet einen nicht definierten DateTimeStyles-Wert.styles includes an undefined DateTimeStyles value.

- oder --or- NoCurrentDateDefault wird nicht unterstützt.NoCurrentDateDefault is not supported.

- oder --or- styles beinhaltet sich gegenseitig ausschließende DateTimeStyles-Werte.styles includes mutually exclusive DateTimeStyles values.

Beispiele

Im folgenden Beispiel wird die TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) -Methode mit standardmäßigen und benutzerdefinierten Format bezeichnerwerten, der invarianten DateTimeStyles Kultur und verschiedenen Werten verwendet, um mehrere Datums-und Uhrzeit Zeichenfolgen zu analysieren.The following example uses the TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) method with standard and custom format specifiers, the invariant culture, and various DateTimeStyles values to parse several date and time strings.

string dateString, format;  
DateTimeOffset result;
IFormatProvider provider = CultureInfo.InvariantCulture;

// Parse date-only value with invariant culture and assume time is UTC.
dateString = "06/15/2008";
format = "d";
if (DateTimeOffset.TryParseExact(dateString, format, provider, 
                                 DateTimeStyles.AssumeUniversal, 
                                 out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);

// Parse date-only value with leading white space.
// Should return False because only trailing white space is  
// specified in method call.
dateString = " 06/15/2008";
if (DateTimeOffset.TryParseExact(dateString, format, provider, 
                                 DateTimeStyles.AllowTrailingWhite, 
                                 out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);

// Parse date and time value, and allow all white space.
dateString = " 06/15/   2008  15:15    -05:00";
format = "MM/dd/yyyy H:mm zzz";
if (DateTimeOffset.TryParseExact(dateString, format, provider, 
                                 DateTimeStyles.AllowWhiteSpaces, 
                                 out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);

// Parse date and time and convert to UTC.
dateString = "  06/15/2008 15:15:30 -05:00";   
format = "MM/dd/yyyy H:mm:ss zzz";       
if (DateTimeOffset.TryParseExact(dateString, format, provider, 
                                DateTimeStyles.AllowWhiteSpaces | 
                                DateTimeStyles.AdjustToUniversal, 
                                out result))
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
else
   Console.WriteLine("'{0}' is not in the correct format.", dateString);
// The example displays the following output:
//    '06/15/2008' converts to 6/15/2008 12:00:00 AM +00:00.
//    ' 06/15/2008' is not in the correct format.
//    ' 06/15/   2008  15:15    -05:00' converts to 6/15/2008 3:15:00 PM -05:00.
//    '  06/15/2008 15:15:30 -05:00' converts to 6/15/2008 8:15:30 PM +00:00.
Dim dateString, format As String  
Dim result As DateTimeOffset
Dim provider As CultureInfo = CultureInfo.InvariantCulture

' Parse date-only value with invariant culture and assume time is UTC.
dateString = "06/15/2008"
format = "d"
If DateTimeOffset.TryParseExact(dateString, format, provider, _
                                   DateTimeStyles.AssumeUniversal, _
                                   result) Then
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Else
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End If 

' Parse date-only value with leading white space.
' Should return False because only trailing white space is  
' specified in method call.
dateString = " 06/15/2008"
If DateTimeOffset.TryParseExact(dateString, format, provider, _
                                DateTimeStyles.AllowTrailingWhite, _
                                result) Then
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Else
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End If 

' Parse date and time value, and allow all white space.
dateString = " 06/15/   2008  15:15    -05:00"
format = "MM/dd/yyyy H:mm zzz"
If DateTimeOffset.TryParseExact(dateString, format, provider, _
                                DateTimeStyles.AllowWhiteSpaces, _
                                result) Then
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Else
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End If 

' Parse date and time and convert to UTC.
dateString = "  06/15/2008 15:15:30 -05:00"   
format = "MM/dd/yyyy H:mm:ss zzz"       
If DateTimeOffset.TryParseExact(dateString, format, provider, _
                                DateTimeStyles.AllowWhiteSpaces Or _
                                DateTimeStyles.AdjustToUniversal, _
                                result) Then
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Else
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End If 
' The example displays the following output:
'    '06/15/2008' converts to 6/15/2008 12:00:00 AM +00:00.
'    ' 06/15/2008' is not in the correct format.
'    ' 06/15/   2008  15:15    -05:00' converts to 6/15/2008 3:15:00 PM -05:00.
'    '  06/15/2008 15:15:30 -05:00' converts to 6/15/2008 8:15:30 PM +00:00.

Im folgenden Beispiel wird eine Vielzahl von DateTimeStyles Werten verwendet, um ein Array von Zeichen folgen zu analysieren, die erwartungsgemäß ISO 8601entsprechen.The following example uses a variety of DateTimeStyles values to parse an array of strings that are expected to conform to ISO 8601. Wie die Ausgabe des Beispiels zeigt, können Zeichen folgen im richtigen Format nicht analysiert werden, wenn:As the output from the example shows, strings that are in the proper format fail to parse if:

Für Zeichen folgen, die keinen UTC-Offset angeben, wird davon ausgegangen, dass Sie den Offset der lokalen Zeitzone aufweisen (in diesem Fall-07:00, der den Offset der Pacific Daylight Time Zone widerspiegelt DateTimeStyles.AssumeUniversal ), es sei denn, das Flag wird im Methodenaufruf angegeben.Strings that do not specify a UTC offset are assumed to have the offset of the local time zone (in this case, -07:00, which reflects the offset of the Pacific Daylight Time zone) unless the DateTimeStyles.AssumeUniversal flag is supplied in the method call. In diesem Fall wird davon ausgegangen, dass es sich um eine universelle koordinierte Zeit handelt.In that case, they are assumed to be Universal Coordinated Time.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] dateStrings = { "2018-08-18T12:45:16.0000000Z",
                               "2018/08/18T12:45:16.0000000Z",
                               "2018-18-08T12:45:16.0000000Z",
                               "2018-08-18T12:45:16.0000000",                               
                               " 2018-08-18T12:45:16.0000000Z ",
                               "2018-08-18T12:45:16.0000000+02:00",
                               "2018-08-18T12:45:16.0000000-07:00" }; 
      
      ParseWithISO8601(dateStrings, DateTimeStyles.None);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AllowWhiteSpaces);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AdjustToUniversal);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AssumeLocal);
      Console.WriteLine("\n-----\n");
      ParseWithISO8601(dateStrings, DateTimeStyles.AssumeUniversal);   }

   private static void ParseWithISO8601(string[] dateStrings, DateTimeStyles styles)
   {   
      Console.WriteLine($"Parsing with {styles}:");
      DateTimeOffset date;
      foreach (var dateString in dateStrings)
      {
         if (DateTimeOffset.TryParseExact(dateString, "O", null, styles, out date))
         {
            Console.WriteLine($"   {dateString,-35} --> {date:yyyy-MM-dd HH:mm:ss.FF zzz}");
         }
         else
         {
            Console.WriteLine($"   Unable to convert '{dateString}'");
         }   
      } 
   }
}
// The example displays the following output:
//      Parsing with None:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
//
//      -----
//
//      Parsing with AllowWhiteSpaces:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//          2018-08-18T12:45:16.0000000Z       --> 2018-08-18 12:45:16 +00:00
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
//
//      -----
//
//      Parsing with AdjustToUniversal:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 19:45:16 +00:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 10:45:16 +00:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 19:45:16 +00:00
//
//      -----
//
//      Parsing with AssumeLocal:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
//
//      -----
//
//      Parsing with AssumeUniversal:
//         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//         Unable to convert '2018/08/18T12:45:16.0000000Z'
//         Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 +00:00
//         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
//         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
//         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
Imports System.Globalization

Public Module Example
   Public Sub Main()
      Dim dateStrings() = { "2018-08-18T12:45:16.0000000Z",
                            "2018/08/18T12:45:16.0000000Z",
                            "2018-18-08T12:45:16.0000000Z",
                            "2018-08-18T12:45:16.0000000",                               
                            " 2018-08-18T12:45:16.0000000Z ",
                            "2018-08-18T12:45:16.0000000+02:00",
                            "2018-08-18T12:45:16.0000000-07:00" } 
      
      ParseWithISO8601(dateStrings, DateTimeStyles.None)
      Console.WriteLine($"{vbCrLf}-----{vbCrLf}")
      ParseWithISO8601(dateStrings, DateTimeStyles.AllowWhiteSpaces)
      Console.WriteLine($"{vbCrLf}-----{vbCrLf}")
      ParseWithISO8601(dateStrings, DateTimeStyles.AdjustToUniversal)
      Console.WriteLine($"{vbCrLf}-----{vbCrLf}")
      ParseWithISO8601(dateStrings, DateTimeStyles.AssumeLocal)
      Console.WriteLine($"{vbCrLf}-----{vbCrLf}")
      ParseWithISO8601(dateStrings, DateTimeStyles.AssumeUniversal)   
   End Sub

   Private Sub ParseWithISO8601(dateStrings() As String, styles As DateTimeStyles)
      Console.WriteLine($"Parsing with {styles}:")
      Dim dat As DateTimeOffset
      For Each dateStr In dateStrings
         If DateTimeOffset.TryParseExact(dateStr, "O", Nothing, styles, dat) Then
            Console.WriteLine($"   {dateStr,-35} --> {dat:yyyy-MM-dd HH:mm:ss.FF zzz}")
         Else
            Console.WriteLine($"   Unable to convert '{dateStr}'")
         End If   
      Next 
   End Sub
End Module
' The example displays the following output:
'      Parsing with None:
'         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
'         Unable to convert '2018/08/18T12:45:16.0000000Z'
'         Unable to convert '2018-18-08T12:45:16.0000000Z'
'         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
'         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
'         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
'         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
'
'      -----
'
'      Parsing with AllowWhiteSpaces:
'         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
'         Unable to convert '2018/08/18T12:45:16.0000000Z'
'         Unable to convert '2018-18-08T12:45:16.0000000Z'
'         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
'          2018-08-18T12:45:16.0000000Z       --> 2018-08-18 12:45:16 +00:00
'         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
'         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
'
'      -----
'
'      Parsing with AdjustToUniversal:
'         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
'         Unable to convert '2018/08/18T12:45:16.0000000Z'
'         Unable to convert '2018-18-08T12:45:16.0000000Z'
'         2018-08-18T12:45:16.0000000         --> 2018-08-18 19:45:16 +00:00
'         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
'         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 10:45:16 +00:00
'         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 19:45:16 +00:00
'
'      -----
'
'      Parsing with AssumeLocal:
'         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
'         Unable to convert '2018/08/18T12:45:16.0000000Z'
'         Unable to convert '2018-18-08T12:45:16.0000000Z'
'         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
'         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
'         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
'         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00
'
'      -----
'
'      Parsing with AssumeUniversal:
'         2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
'         Unable to convert '2018/08/18T12:45:16.0000000Z'
'         Unable to convert '2018-18-08T12:45:16.0000000Z'
'         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 +00:00
'         Unable to convert ' 2018-08-18T12:45:16.0000000Z '
'         2018-08-18T12:45:16.0000000+02:00   --> 2018-08-18 12:45:16 +02:00
'         2018-08-18T12:45:16.0000000-07:00   --> 2018-08-18 12:45:16 -07:00

Hinweise

Diese über TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) Ladung der-Methode ähnelt der DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) -Methode, mit der Ausnahme, dass diese Methode keine Ausnahme auslöst, wenn bei der Konvertierung ein Fehler auftritt.This overload of the TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) method is like the DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) method, except that this method does not throw an exception if the conversion fails. Es analysiert die Zeichen folgen Darstellung eines Datums und einer Uhrzeit, die exakt mit dem durch den format -Parameter angegebenen Muster übereinstimmen müssen.It parses the string representation of a date and time that must exactly match the pattern specified by the format parameter. Wenn die input Zeichenfolge nicht mit diesem Muster identisch ist, und einige mögliche Variationen im Leerraum durch styles den-Parameter definiert sind, schlägt der Verarbeitungsvorgang fehl false, und die-Methode gibt zurück.If the input string does not match this pattern, with some possible variations in white space defined by the styles parameter, the parsing operation fails and the method returns false.

Der format -Parameter ist eine Zeichenfolge, die entweder einen einzelnen Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthält, die inputdas erforderliche Muster von definieren.The format parameter is a string that contains either a single standard format specifier or one or more custom format specifiers that define the required pattern of input. Details zu gültigen Formatierungscodes finden Sie unter Standard Format Zeichenfolgen für Datum und Uhrzeit und benutzerdefinierte Format Zeichenfolgen für Datum und Uhrzeit.For details about valid formatting codes, see Standard Date and Time Format Strings and Custom Date and Time Format Strings. Wenn format zzdie zbenutzerdefinierten Format Bearbeiter, oder zzz enthält, um anzugeben, dass ein Offset in inputvorhanden sein muss, muss dieser Offset entweder ein negatives oder ein positives Vorzeichen enthalten.If format includes the z, zz, or zzz custom format specifiers to indicate that an offset must be present in input, that offset must include either a negative sign or a positive sign. Wenn das Vorzeichen fehlt, schlägt der Verarbeitungsvorgang fehl, und die Methode gibt falsezurück.If the sign is missing, the parsing operation fails and the method returns false.

Wenn format erfordert, input dass ein Datum, aber keine Uhrzeit enthält, wird DateTimeOffset dem resultierenden Objekt eine Uhrzeit von Mitternacht (0:00:00) zugewiesen.If format requires that input contain a date but not a time, the resulting DateTimeOffset object is assigned a time of midnight (0:00:00). Wenn format erfordert, input dass eine Uhrzeit, aber kein Datum enthält, wird DateTimeOffset dem resultierenden Objekt das aktuelle Datum auf dem lokalen System zugewiesen.If format requires that input contain a time but not a date, the resulting DateTimeOffset object is assigned the current date on the local system. Wenn format nicht erfordert, dass input einen Offset enthalten, hängt der Offset des resultierenden DateTimeOffset Objekts vom Wert des styles -Parameters ab.If format does not require that input contain an offset, the offset of the resulting DateTimeOffset object depends on the value of the styles parameter. Wenn styles den AssumeLocalWert enthält, wird der Offset der lokalen Zeitzone dem DateTimeOffset -Objekt zugewiesen.If styles includes AssumeLocal, the offset of the local time zone is assigned to the DateTimeOffset object. Wenn styles den AssumeUniversalWert enthält, wird der koordinierte Weltzeit (UTC) oder + 00:00 dem- DateTimeOffset Objekt zugewiesen.If styles includes AssumeUniversal, the Coordinated Universal Time (UTC) offset, or +00:00, is assigned to the DateTimeOffset object. Wenn kein Wert angegeben ist, wird der Offset der lokalen Zeitzone verwendet.If neither value is specified, the offset of the local time zone is used.

Die bestimmten Datums-und Uhrzeit Symbole und Zeichen folgen input , die in verwendet formatProvider werden, werden durch den-Parameter definiert.The particular date and time symbols and strings used in input are defined by the formatProvider parameter. Das gleiche gilt für das genaue Muster von input , wenn format eine Standardformat Bezeichner-Zeichenfolge ist.The same is true for the precise pattern of input if format is a standard format specifier string. Der formatProvider Parameter kann eine der folgenden sein:The formatProvider parameter can be either of the following:

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

Der styles -Parameter definiert, ob Leerzeichen in der Eingabe Zeichenfolge zulässig sind, gibt an, wie Zeichen folgen ohne explizite Offset Komponente analysiert werden, und unterstützt die UTC-Konvertierung als Teil des Analyse Vorgangs.The styles parameter defines whether white space is allowed in the input string, indicates how strings without an explicit offset component are parsed, and supports UTC conversion as part of the parsing operation. Alle Member der DateTimeStyles -Enumeration werden außer NoCurrentDateDefaultunterstützt.All members of the DateTimeStyles enumeration are supported except NoCurrentDateDefault. In der folgenden Tabelle sind die Auswirkungen der einzelnen unterstützten Member aufgeführt.The following table lists the effect of each supported member.

DateTimeStyles -MemberDateTimeStyles member VerhaltenBehavior
AdjustToUniversal input Analysiert und konvertiert ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht dem Initialisieren einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime -Methode des zurück DateTimeOffset gegebenen-Objekts.It is equivalent to parsing a string, and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AssumeLocal Wenn format nicht erfordert, dass input einen Offset-Wert enthält, wird DateTimeOffset dem zurückgegebenen Objekt der Offset der lokalen Zeitzone zugewiesen.If format does not require that input contain an offset value, the returned DateTimeOffset object is given the offset of the local time zone. Dies ist das Standardverhalten.This is the default behavior.
AssumeUniversal Wenn format nicht erfordert, dass input einen Offset-Wert enthält, erhält DateTimeOffset das zurückgegebene Objekt den UTC-Offset (+ 00:00).If format does not require that input contain an offset value, the returned DateTimeOffset object is given the UTC offset (+00:00).
AllowInnerWhite Ermöglicht input das Einschließen von inneren Leerraum, der nicht durch das Format angegeben wird.Allows input to include inner white space not specified by format. Zusätzliche Leerräume können zwischen Datums-und Uhrzeit Komponenten und innerhalb einzelner Komponenten, außer dem Offset, angezeigt werden und werden bei der Verarbeitung der Zeichenfolge ignoriert.Extra white space can appear between date and time components and within individual components, other than the offset, and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, formatdie nicht von angegeben werden.Allows input to include leading spaces not specified by format. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowTrailingWhite Ermöglicht input das Einschließen von nachfolgenden Leerzeichen format, die nicht von angegeben werdenAllows input to include trailing spaces not specified by format. Diese werden bei der Verarbeitung der Zeichenfolge ignoriert.These are ignored when parsing the string.
AllowWhiteSpaces Ermöglicht input das Einschließen von führenden, nachfolgenden und inneren Leerzeichen, formatdie nicht von angegeben werden.Allows input to include leading, trailing, and inner spaces not specified by format. Alle zusätzlichen Leerzeichen, die nicht in format angegeben sind, werden beim Auswerten der Zeichenfolge ignoriert.All extra white-space characters not specified in format are ignored when parsing the string.
None Gibt an, dass zusätzliche Leerzeichen in inputnicht zulässig sind.Indicates that additional white space is not permitted in input. Leerraum muss genau wie in formatangegeben angezeigt werden.White space must appear exactly as specified in format. Dies ist das Standardverhalten.This is the default behavior.
RoundtripKind Hat keine Auswirkung, da die DateTimeOffset -Struktur keine- Kind Eigenschaft enthält.Has no effect, because the DateTimeOffset structure does not include a Kind property.

Hinweise für Aufrufer

In gibt die zurück TryParseExact .NET Framework 4.NET Framework 4 false , wenn die zu erteilende Zeichenfolge eine Stunden Komponente und einen am/pm-Kenn Zeichner enthält, der nicht in der Vereinbarung ist.In the .NET Framework 4.NET Framework 4, the TryParseExact 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: