DateTimeOffset.ParseExact Methode

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

ParseExact(String, String[], IFormatProvider, DateTimeStyles)

Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in den entsprechenden DateTimeOffset.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified 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.

ParseExact(String, String, IFormatProvider, DateTimeStyles)

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 Zeichenfolgendarstellung muss dem angegebenen Format genau entsprechen.The format of the string representation must match the specified format exactly.

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Konvertiert einen Zeichenbereich, der eine Datums- und Uhrzeitangabe darstellt, unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in den entsprechenden DateTimeOffset.Converts a character span that represents a date and time 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.

ParseExact(String, String, IFormatProvider)

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

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

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

ParseExact(String, String[], IFormatProvider, DateTimeStyles)

Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in den entsprechenden DateTimeOffset.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified 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 DateTimeOffset ParseExact(System::String ^ input, cli::array <System::String ^> ^ formats, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles);
public static DateTimeOffset ParseExact (string input, string[] formats, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles);
static member ParseExact : string * string[] * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset
Public Shared Function ParseExact (input As String, formats As String(), formatProvider As IFormatProvider, styles As DateTimeStyles) As DateTimeOffset

Parameter

input
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 von Formatbezeichnern, die die erwarteten Formate von input definieren.An array of format specifiers that define the expected formats of input.

formatProvider
IFormatProvider

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

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

Gibt zurück

Ein Objekt, das der im input-Parameter enthaltenen Datums- und Uhrzeitangabe nach den Angaben der Parameter formats, formatProvider und styles entspricht.An object that is equivalent to the date and time that is contained in the input parameter, as specified by the formats, formatProvider, and styles parameters.

Ausnahmen

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.The offset is greater than 14 hours or less than -14 hours.

- oder --or- styles schließt einen nicht unterstützten Wert ein.styles includes an unsupported value.

- oder --or- Der styles-Parameter enthält DateTimeStyles-Werte, die nicht zusammen verwendet werden können.The styles parameter contains DateTimeStyles values that cannot be used together.

input ist null.input is null.

input ist eine leere Zeichenfolge ("").input is an empty string ("").

- oder --or- input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.input does not contain a valid string representation of a date and time.

- oder --or- Kein Element von formats enthält einen gültigen Formatbezeichner.No element of formats contains a valid format specifier.

- oder --or- Die Komponente für Stunden und der AM/PM-Kennzeichner in input stimmen nicht überein.The hour component and the AM/PM designator in input do not agree.

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 an die DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles)-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 DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) 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 = new 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();
    try
    {
       result = DateTimeOffset.ParseExact(input, formats, provider, 
                                          DateTimeStyles.AllowWhiteSpaces);
       break;
    }
    catch (FormatException)
    {
       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() 
    Try
       result = DateTimeOffset.ParseExact(input, formats, provider, _
                                          DateTimeStyles.AllowWhiteSpaces)
       Exit Do
    Catch e As FormatException
       Console.WriteLine("Unable to parse {0}.", input)      
       tries += 1
    End Try
 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 DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles)-Methode analysiert die Zeichen folgen Darstellung eines Datums, das mit einem der Muster übereinstimmt, die dem formats-Parameter zugewiesen sind.The DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) method parses the string representation of a date that matches any one of the patterns assigned to the formats parameter. Wenn die input Zeichenfolge mit keinem dieser Muster mit einer der vom styles-Parameter definierten Variationen identisch ist, löst die Methode eine FormatExceptionaus.If the input string does not match any one of these patterns with any of the variations defined by the styles parameter, the method throws a FormatException. Abgesehen vom Vergleich von input mit mehreren Formatierungs Mustern verhält sich diese Überladung identisch mit der DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles)-Methode.Aside from comparing input to multiple formatting patterns, 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 das mögliche Muster des input-Parameters 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 the input parameter. Wenn die-Methode aufgerufen wird, muss input einem dieser Muster entsprechen.When the method is called, input must match one of these patterns. 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 Element in formats die z, zzoder zzz benutzerdefinierten Format Bearbeiter enthält, um anzugeben, dass ein Offset in inputvorhanden 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, löst die Methode eine FormatExceptionaus.If the sign is missing, the method throws a FormatException.

Wichtig

Wenn Sie den formats-Parameter dieser Überladung verwenden, um mehrere Formate anzugeben, können Sie die Frustration vieler Benutzer beim Eintreten von Datums-und Uhrzeitangaben verringern.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 Element in formats erfordert, dass input ein Datum, aber keine Uhrzeit enthalten, wird dem resultierenden DateTimeOffset 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 Element in formats erfordert, dass input eine Uhrzeit, aber kein Datum enthalten, wird dem resultierenden DateTimeOffset 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 Element in formats nicht erfordert, dass input einen Offset enthalten, hängt der Offset des resultierenden DateTimeOffset 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 AssumeLocalenthä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 AssumeUniversalenthä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, die in input verwendet werden, werden durch den formatProvider-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 Format von input, wenn das übereinstimmende Element von formats eine standardmäßige formatspezifiziererzeichenfolge ist.The same is true for the precise format of input, if the matching element of formats is a standard format specifier string. Der formatProvider-Parameter kann eine der folgenden Optionen sein:The formatProvider parameter can be either of the following:

Wenn formatprovider nullist, wird das CultureInfo-Objekt verwendet, das der aktuellen Kultur entspricht.If 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 mit Ausnahme von 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 Analysiert input und konvertiert Sie ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht dem Durchlaufen einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime-Methode des zurückgegebenen DateTimeOffset Objekts.It is equivalent to parsing a string, and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AssumeLocal Wenn das übereinstimmende Element in formats nicht erfordert, dass input einen Offset Wert enthalten, wird dem zurückgegebenen DateTimeOffset 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 Element in formats nicht erfordert, dass input einen Offset Wert enthalten, erhält das zurückgegebene DateTimeOffset 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 Leerzeichen, die nicht durch formatangegeben werden.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 (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 the offset), and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, die nicht durch formatsangegeben werden.Allows input to include leading spaces not specified by 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 durch formatsangegeben werdenAllows input to include trailing spaces not specified by 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 durch formatsangegeben werden.Allows input to include leading, trailing, and inner spaces not specified by 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 wie in einem bestimmten Element von formats angegeben werden, damit eine Übereinstimmung auftritt.White space must appear exactly as specified in a particular element of formats for a match to occur. 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 der .NET Framework 4.NET Framework 4löst die ParseExact-Methode eine FormatException aus, wenn die zu deaktivier Ende 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 ParseExact method throws a FormatException if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. In der .NET Framework 3,5.NET Framework 3.5 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

ParseExact(String, String, IFormatProvider, DateTimeStyles)

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 Zeichenfolgendarstellung muss dem angegebenen Format genau entsprechen.The format of the string representation must match the specified format exactly.

public:
 static DateTimeOffset ParseExact(System::String ^ input, System::String ^ format, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles);
public static DateTimeOffset ParseExact (string input, string format, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles);
static member ParseExact : string * string * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset
Public Shared Function ParseExact (input As String, format As String, formatProvider As IFormatProvider, styles As DateTimeStyles) As DateTimeOffset

Parameter

input
String

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

format
String

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

formatProvider
IFormatProvider

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

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

Gibt zurück

Ein Objekt, das der im input-Parameter enthaltenen Datums- und Uhrzeitangabe nach den Angaben der Parameter format, formatProvider und styles entspricht.An object that is equivalent to the date and time that is contained in the input parameter, as specified by the format, formatProvider, and styles parameters.

Ausnahmen

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.The offset is greater than 14 hours or less than -14 hours.

- oder --or- Der styles-Parameter schließt einen nicht unterstützten Wert ein.The styles parameter includes an unsupported value.

- oder --or- Der styles-Parameter enthält DateTimeStyles-Werte, die nicht zusammen verwendet werden können.The styles parameter contains DateTimeStyles values that cannot be used together.

input ist null.input is null.

- oder --or- format ist null.format is null.

input ist eine leere Zeichenfolge ("").input is an empty string ("").

- oder --or- input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.input does not contain a valid string representation of a date and time.

- oder --or- format ist eine leere Zeichenfolge.format is an empty string.

- oder --or- Die Komponente für Stunden und der AM/PM-Kennzeichner in input stimmen nicht überein.The hour component and the AM/PM designator in input do not agree.

Beispiele

Im folgenden Beispiel wird die DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles)-Methode mit standardmäßigen und benutzerdefinierten Format bezeichnerwerten, der invarianten Kultur und verschiedenen DateTimeStyles Werten verwendet, um mehrere Datums-und Uhrzeit Zeichenfolgen zu analysieren.The following example uses the DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) 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;
CultureInfo provider = CultureInfo.InvariantCulture;

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

// Parse date-only value with leading white space.
// Should throw a FormatException because only trailing white space is  
// specified in method call.
dateString = " 06/15/2008";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider, 
                                      DateTimeStyles.AllowTrailingWhite);
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
}   
catch (FormatException)
{
   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";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider, 
                                      DateTimeStyles.AllowWhiteSpaces);
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
}   
catch (FormatException)
{
   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"; 
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider, 
                                      DateTimeStyles.AllowWhiteSpaces |
                                      DateTimeStyles.AdjustToUniversal);
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   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"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AssumeUniversal)
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End Try 

' Parse date-only value with leading white space.
' Should throw a FormatException because only trailing white space is  
' specified in method call.
dateString = " 06/15/2008"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AllowTrailingWhite)
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End Try 

' 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"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AllowWhiteSpaces)
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End Try 

' 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"       
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AllowWhiteSpaces Or _
                                      DateTimeStyles.AdjustToUniversal)
   Console.WriteLine("'{0}' converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("'{0}' is not in the correct format.", dateString)
End Try 
' 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), es sei denn, das DateTimeStyles.AssumeUniversal-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) 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}:");
      foreach (var dateString in dateStrings)
      {
         try {
            var date = DateTimeOffset.ParseExact(dateString, "O", null, styles);
            Console.WriteLine($"   {dateString,-35} --> {date:yyyy-MM-dd HH:mm:ss.FF zzz}");
         }
         catch (FormatException)
         {
            Console.WriteLine($"   FormatException: 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
//         FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
//         FormatException: Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//         FormatException: 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
//         FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
//         FormatException: 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
//         FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
//         FormatException: Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 19:45:16 +00:00
//         FormatException: 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
//         FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
//         FormatException: Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 -07:00
//         FormatException: 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
//         FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
//         FormatException: Unable to convert '2018-18-08T12:45:16.0000000Z'
//         2018-08-18T12:45:16.0000000         --> 2018-08-18 12:45:16 +00:00
//         FormatException: 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}:")
      For Each dateStr In dateStrings
         Try 
            Dim dat = DateTimeOffset.ParseExact(dateString, "O", Nothing, styles)
            Console.WriteLine($"   {dateString,-35} --> {dat:yyyy-MM-dd HH:mm:ss.FF zzz}")
         catch e As FormatException
            Console.WriteLine($"   FormatException: Unable to convert '{dateString}'")
         End Try   
      Next 
   End Sub
End Module
' The example displays the following output:
'      Parsing with None:
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'
'      -----
'
'      Parsing with AllowWhiteSpaces:
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'
'      -----
'
'      Parsing with AdjustToUniversal:
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'
'      -----
'
'      Parsing with AssumeLocal:
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'
'      -----
'
'      Parsing with AssumeUniversal:
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'
'         FormatException: Unable to convert '07-30-2018'

Hinweise

Die DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles)-Methode analysiert die Zeichen folgen Darstellung eines Datums, das in dem vom format-Parameter definierten Format vorliegen muss.The DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) method parses the string representation of a date, which must be in the format defined by the format parameter. Außerdem ist es erforderlich, dass die <Date >, <Time > und <Offset > Elemente der Zeichen folgen Darstellung eines Datums und einer Uhrzeit in der von formatangegebenen Reihenfolge angezeigt werden.It also requires that the <Date>, <Time>, and <Offset> elements of the string representation of a date and time appear in the order specified by format. Wenn die input Zeichenfolge nicht mit dem Muster des format-Parameters identisch ist, löst die Methode eine FormatExceptionaus, die durch den styles-Parameter definiert wird.If the input string does not match the pattern of the format parameter, with any variations defined by the styles parameter, the method throws a FormatException. Im Gegensatz dazu analysiert die DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles)-Methode die Zeichen folgen Darstellung eines Datums in einem beliebigen Format, das vom DateTimeFormatInfo-Objekt des Format Anbieters erkannt wird.In contrast, the DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles) method parses the string representation of a date in any one of the formats recognized by the format provider's DateTimeFormatInfo object. Parse ermöglicht außerdem das <Date->, <Time > und <Offset > Elementen der Zeichen folgen Darstellung eines Datums und einer Uhrzeit, die in beliebiger Reihenfolge angezeigt werden.Parse also allows the <Date>, <Time>, and <Offset> elements of the string representation of a date and time to appear in any order.

Der format-Parameter ist eine Zeichenfolge, die entweder einen einzelnen Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthält, die das erforderliche Muster des input-Parameters 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 the input parameter. 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 die benutzerdefinierten Format Bearbeiter z, zzoder 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, löst die Methode eine FormatExceptionaus.If the sign is missing, the method throws a FormatException.

Wenn format erfordert, dass input ein Datum, aber keine Uhrzeit enthalten, wird dem resultierenden DateTimeOffset 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, dass input eine Uhrzeit, aber kein Datum enthalten, wird dem resultierenden DateTimeOffset 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 AssumeLocalenthä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 AssumeUniversalenthä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, die in input verwendet werden, werden durch den formatProvider-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 Format von input, wenn format eine Standardformat Bezeichner-Zeichenfolge ist.The same is true for the precise format of input, if format is a standard format specifier string. Der formatProvider-Parameter kann eine der folgenden Optionen sein:The formatProvider parameter can be either of the following:

Wenn formatprovider nullist, wird das CultureInfo-Objekt verwendet, das der aktuellen Kultur entspricht.If 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 mit Ausnahme von 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 Analysiert input und konvertiert Sie ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht dem Durchlaufen einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime-Methode des zurückgegebenen DateTimeOffset 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 enthalten, erhält das zurückgegebene DateTimeOffset Objekt den Offset der lokalen Zeitzone.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 der Standardwert.This is the default value.
AssumeUniversal Wenn format nicht erfordert, dass input einen Offset Wert enthalten, erhält das zurückgegebene DateTimeOffset 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 Leerzeichen, die nicht durch formatangegeben werden.Allows input to include inner white space not specified by format. Zusätzliche Leerzeichen können zwischen Datums-und Uhrzeit Komponenten und innerhalb einzelner Komponenten angezeigt werden und werden bei der Verarbeitung der Zeichenfolge ignoriert.Extra white space can appear between date and time components and within individual components, and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, die nicht durch formatangegeben 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, die nicht durch formatangegeben 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, die nicht durch formatangegeben 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 der .NET Framework 4.NET Framework 4löst die ParseExact-Methode eine FormatException aus, wenn die zu deaktivier Ende 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 ParseExact method throws a FormatException if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. In der .NET Framework 3,5.NET Framework 3.5 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

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Konvertiert einen Zeichenbereich, der eine Datums- und Uhrzeitangabe darstellt, unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in den entsprechenden DateTimeOffset.Converts a character span that represents a date and time 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 DateTimeOffset ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);
static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset
Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), formatProvider As IFormatProvider, Optional styles As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTimeOffset

Parameter

input
ReadOnlySpan<Char>

Ein Zeichenbereich, der ein Datum und eine Uhrzeit darstellt.A character span that represents a date and time.

format
ReadOnlySpan<Char>

Ein Zeichenbereich mit einem Formatspezifizierer, der das erwartete Format von input definiert.A character span that contains a format specifier that defines the expected format of input.

formatProvider
IFormatProvider

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

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

Gibt zurück

Ein Objekt, das der im input-Parameter enthaltenen Datums- und Uhrzeitangabe nach den Angaben der Parameter format, formatProvider und styles entspricht.An object that is equivalent to the date and time that is contained in the input parameter, as specified by the format, formatProvider, and styles parameters.

Ausnahmen

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.The offset is greater than 14 hours or less than -14 hours.
- oder --or-
Der styles-Parameter schließt einen nicht unterstützten Wert ein.The styles parameter includes an unsupported value.
- oder --or-
Der styles-Parameter enthält DateTimeStyles-Werte, die nicht zusammen verwendet werden können.The styles parameter contains DateTimeStyles values that cannot be used together.

input ist einer leerer Zeichenbereich.input is an empty character span.
oder input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.-or- input does not contain a valid string representation of a date and time.
oder format ist einer leerer Zeichenbereich.-or- format is an empty character span.
- oder --or-
Die Stundenkomponente und der AM/PM-Kennzeichner in input stimmen nicht überein.The hour component and the AM/PM designator in input do not agree.

Hinweise

Diese Methode analysiert eine Zeichen Spanne, die ein Datum darstellt, das in dem vom format-Parameter definierten Format vorliegen muss.This method parses a character span that represents a date, which must be in the format defined by the format parameter. Außerdem ist es erforderlich, dass die <Date >, <Time > und <Offset > Elemente der Zeichen folgen Darstellung eines Datums und einer Uhrzeit in der von formatangegebenen Reihenfolge angezeigt werden.It also requires that the <Date>, <Time>, and <Offset> elements of the string representation of a date and time appear in the order specified by format. Wenn input nicht mit dem format Muster identisch ist, löst die Methode eine FormatExceptionaus.If input does not match the format pattern, the method throws a FormatException. Im Gegensatz dazu analysiert die DateTimeOffset.Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)-Methode die Zeichen folgen Darstellung eines Datums in einem beliebigen Format, das vom DateTimeFormatInfo-Objekt des Format Anbieters erkannt wird.In contrast, the DateTimeOffset.Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) method parses the string representation of a date in any one of the formats recognized by the format provider's DateTimeFormatInfo object. Parse ermöglicht außerdem das <Date->, <Time > und <Offset > Elementen der Zeichen folgen Darstellung eines Datums und einer Uhrzeit, die in beliebiger Reihenfolge angezeigt werden.Parse also allows the <Date>, <Time>, and <Offset> elements of the string representation of a date and time to appear in any order.

Der format-Parameter ist eine Zeichen Spanne, die entweder einen Einzelzeichen-Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthält, die das erforderliche Format des input-Parameters definieren.The format parameter is a character span that contains either a single-character standard format specifier or one or more custom format specifiers that define the required format of the input parameter. 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 die benutzerdefinierten Format Bearbeiter z, zzoder 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, löst die Methode eine FormatExceptionaus.If the sign is missing, the method throws a FormatException.

Wenn format erfordert, dass input ein Datum, aber keine Uhrzeit enthalten, wird dem resultierenden DateTimeOffset 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, dass input eine Uhrzeit, aber kein Datum enthalten, wird dem resultierenden DateTimeOffset 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, wird dem resultierenden DateTimeOffset Objekt der Zeit Zonen Offset des lokalen Systems zugewiesen.If format does not require that input contain an offset, the resulting DateTimeOffset object is assigned the time zone offset of the local system.

Die bestimmten Datums-und Uhrzeit Symbole und Zeichen folgen, die in input verwendet werden, werden durch den formatProvider-Parameter definiert, ebenso wie das genaue Format von input, wenn format ein Standardformat Bezeichner ist.The particular date and time symbols and strings used in input are defined by the formatProvider parameter, as is the precise format of input if format is a standard format specifier. Der formatProvider-Parameter kann eine der folgenden Optionen sein:The formatProvider parameter can be either of the following:

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

ParseExact(String, String, IFormatProvider)

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

public:
 static DateTimeOffset ParseExact(System::String ^ input, System::String ^ format, IFormatProvider ^ formatProvider);
public static DateTimeOffset ParseExact (string input, string format, IFormatProvider formatProvider);
static member ParseExact : string * string * IFormatProvider -> DateTimeOffset
Public Shared Function ParseExact (input As String, format As String, formatProvider As IFormatProvider) As DateTimeOffset

Parameter

input
String

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

format
String

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

formatProvider
IFormatProvider

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

Gibt zurück

Ein Objekt, das der in input enthaltenen Datums- und Uhrzeitangabe nach den Angaben von format und formatProvider entspricht.An object that is equivalent to the date and time that is contained in input as specified by format and formatProvider.

Ausnahmen

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.The offset is greater than 14 hours or less than -14 hours.

input ist null.input is null.

- oder --or- format ist null.format is null.

input ist eine leere Zeichenfolge ("").input is an empty string ("").

- oder --or- input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.input does not contain a valid string representation of a date and time.

- oder --or- format ist eine leere Zeichenfolge.format is an empty string.

- oder --or- Die Komponente für Stunden und der AM/PM-Kennzeichner in input stimmen nicht überein.The hour component and the AM/PM designator in input do not agree.

Beispiele

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

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

// Parse date-only value with invariant culture.
dateString = "06/15/2008";
format = "d";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}   
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 

// Parse date-only value without leading zero in month using "d" format.
// Should throw a FormatException because standard short date pattern of 
// invariant culture requires two-digit month.
dateString = "6/15/2008";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 

// Parse date and time with custom specifier.
dateString = "Sun 15 Jun 2008 8:30 AM -06:00";
format = "ddd dd MMM yyyy h:mm tt zzz";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 

// Parse date and time with offset without offset//s minutes.
// Should throw a FormatException because "zzz" specifier requires leading  
// zero in hours.
dateString = "Sun 15 Jun 2008 8:30 AM -06";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   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 -07:00.
//    6/15/2008 is not in the correct format.
//    Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 8:30:00 AM -06:00.
//    Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.                     
Dim dateString, format As String  
Dim result As DateTimeOffset
Dim provider As CultureInfo = CultureInfo.InvariantCulture

' Parse date-only value with invariant culture.
dateString = "06/15/2008"
format = "d"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider)
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("{0} is not in the correct format.", dateString)
End Try 

' Parse date-only value without leading zero in month using "d" format.
' Should throw a FormatException because standard short date pattern of 
' invariant culture requires two-digit month.
dateString = "6/15/2008"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider)
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("{0} is not in the correct format.", dateString)
End Try 

' Parse date and time with custom specifier.
dateString = "Sun 15 Jun 2008 8:30 AM -06:00"
format = "ddd dd MMM yyyy h:mm tt zzz"        
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider)
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("{0} is not in the correct format.", dateString)
End Try 

' Parse date and time with offset without offset's minutes.
' Should throw a FormatException because "zzz" specifier requires leading  
' zero in hours.
dateString = "Sun 15 Jun 2008 8:30 AM -06"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider)
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString())
Catch e As FormatException
   Console.WriteLine("{0} is not in the correct format.", dateString)
End Try 
' The example displays the following output:
'    06/15/2008 converts to 6/15/2008 12:00:00 AM -07:00.
'    6/15/2008 is not in the correct format.
'    Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 8:30:00 AM -06:00.
'    Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.                     

Im folgenden Beispiel wird ein Array von Zeichen folgen analysiert, die erwartungsgemäß ISO 8601entsprechen.The following example parses an array of strings that are expected to conform to ISO 8601. Wie die Ausgabe des Beispiels zeigt, können Zeichen folgen mit führenden oder nachfolgenden Leerzeichen nicht erfolgreich analysiert werden, ebenso wie Zeichen folgen mit Datums-und Uhrzeit Elementen außerhalb des gültigen Bereichs.As the output from the example shows, strings with leading or trailing spaces fail to parse successfully, as do strings with date and time elements that are out of range.

using System;

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.0000000Z ",
                               "2018-08-18T12:45:16.0000000+02:00",
                               "2018-08-18T12:45:16.0000000-07:00" }; 
      
      foreach (var dateString in dateStrings)
      {
         try {
            var date = DateTimeOffset.ParseExact(dateString, "O", null);
            Console.WriteLine($"{dateString,-35} --> {date:yyyy-MM-dd HH:mm:ss.FF zzz}");
         }
         catch (FormatException)
         {
            Console.WriteLine($"FormatException: Unable to convert '{dateString}'");
         }   

      } 
   }
}
// The example displays the following output:
//      2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
//      FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
//      FormatException: Unable to convert '2018-18-08T12:45:16.0000000Z'
//      FormatException: 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
Public Module Example
   Public Sub Main()
      Dim dateStrings() As String = { "2018-08-18T12:45:16.0000000Z",
                                      "2018/08/18T12:45:16.0000000Z",
                                      "2018-18-08T12:45:16.0000000Z",
                                      " 2018-08-18T12:45:16.0000000Z ",
                                      "2018-08-18T12:45:16.0000000+02:00",
                                      "2018-08-18T12:45:16.0000000-07:00" } 
      
      For Each dateStr In dateStrings
         Try 
            Dim dat = DateTimeOffset.ParseExact(dateStr, "O", Nothing)
            Console.WriteLine($"{dateStr,-35} --> {dat:yyyy-MM-dd HH:mm:ss.FF zzz}")
         Catch  e As FormatException
            Console.WriteLine($"FormatException: Unable to convert '{dateStr}'")
         End Try   
      Next 
   End Sub
End Module
' The example displays the following output:
'      2018-08-18T12:45:16.0000000Z        --> 2018-08-18 12:45:16 +00:00
'      FormatException: Unable to convert '2018/08/18T12:45:16.0000000Z'
'      FormatException: Unable to convert '2018-18-08T12:45:16.0000000Z'
'      FormatException: 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

Die ParseExact(String, String, IFormatProvider)-Methode analysiert die Zeichen folgen Darstellung eines Datums, das in dem vom format-Parameter definierten Format vorliegen muss.The ParseExact(String, String, IFormatProvider) method parses the string representation of a date, which must be in the format defined by the format parameter. Außerdem ist es erforderlich, dass die <Date >, <Time > und <Offset > Elemente der Zeichen folgen Darstellung eines Datums und einer Uhrzeit in der von formatangegebenen Reihenfolge angezeigt werden.It also requires that the <Date>, <Time>, and <Offset> elements of the string representation of a date and time appear in the order specified by format. Wenn die input Zeichenfolge nicht mit diesem format Parameter identisch ist, löst die Methode eine FormatExceptionaus.If the input string does not match this format parameter, the method throws a FormatException. Im Gegensatz dazu analysiert die DateTimeOffset.Parse(String, IFormatProvider)-Methode die Zeichen folgen Darstellung eines Datums in einem beliebigen Format, das vom DateTimeFormatInfo-Objekt des Format Anbieters erkannt wird.In contrast, the DateTimeOffset.Parse(String, IFormatProvider) method parses the string representation of a date in any one of the formats recognized by the format provider's DateTimeFormatInfo object. Parse ermöglicht außerdem das <Date->, <Time > und <Offset > Elementen der Zeichen folgen Darstellung eines Datums und einer Uhrzeit, die in beliebiger Reihenfolge angezeigt werden.Parse also allows the <Date>, <Time>, and <Offset> elements of the string representation of a date and time to appear in any order.

Der format-Parameter ist eine Zeichenfolge, die entweder einen einzelnen Standardformat Bezeichner oder einen oder mehrere benutzerdefinierte Format Bezeichner enthält, die das erforderliche Format des input-Parameters 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 format of the input parameter. 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 die benutzerdefinierten Format Bearbeiter z, zzoder 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, löst die Methode eine FormatExceptionaus.If the sign is missing, the method throws a FormatException.

Wenn format erfordert, dass input ein Datum, aber keine Uhrzeit enthalten, wird dem resultierenden DateTimeOffset 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, dass input eine Uhrzeit, aber kein Datum enthalten, wird dem resultierenden DateTimeOffset 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, wird dem resultierenden DateTimeOffset Objekt der Zeit Zonen Offset des lokalen Systems zugewiesen.If format does not require that input contain an offset, the resulting DateTimeOffset object is assigned the time zone offset of the local system.

Die bestimmten Datums-und Uhrzeit Symbole und Zeichen folgen, die in input verwendet werden, werden durch den formatProvider-Parameter definiert, ebenso wie das genaue Format von input, wenn format eine Standardformat Bezeichner-Zeichenfolge ist.The particular date and time symbols and strings used in input are defined by the formatProvider parameter, as is the precise format of input if format is a standard format specifier string. Der formatProvider-Parameter kann eine der folgenden Optionen sein:The formatProvider parameter can be either of the following:

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

Hinweise für Aufrufer

In der .NET Framework 4.NET Framework 4löst die ParseExact-Methode eine FormatException aus, wenn die zu deaktivier Ende 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 ParseExact method throws a FormatException if the string to be parsed contains an hour component and an AM/PM designator that are not in agreement. In der .NET Framework 3,5.NET Framework 3.5 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

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

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

public static DateTimeOffset ParseExact (ReadOnlySpan<char> input, string[] formats, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);
static member ParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset
Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), formats As String(), formatProvider As IFormatProvider, Optional styles As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTimeOffset

Parameter

input
ReadOnlySpan<Char>

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

formats
String[]

Ein Array von Formatbezeichnern, die die erwarteten Formate von input definieren.An array of format specifiers that define the expected formats of input.

formatProvider
IFormatProvider

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

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

Gibt zurück

Ein Objekt, das der im input-Parameter enthaltenen Datums- und Uhrzeitangabe nach den Angaben der Parameter formats, formatProvider und styles entspricht.An object that is equivalent to the date and time that is contained in the input parameter, as specified by the formats, formatProvider, and styles parameters.

Ausnahmen

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.The offset is greater than 14 hours or less than -14 hours.
oder styles enthält einen nicht unterstützten Wert.-or- styles includes an unsupported value.
- oder --or-
Der styles-Parameter enthält DateTimeStyles-Werte, die nicht zusammen verwendet werden können.The styles parameter contains DateTimeStyles values that cannot be used together.

input ist einer leerer Zeichenbereich.input is an empty character span.
oder input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.-or- input does not contain a valid string representation of a date and time.
- oder --or-
Kein Element von formats enthält einen gültigen Formatbezeichner.No element of formats contains a valid format specifier.
- oder --or-
Die Komponente für Stunden und der AM/PM-Kennzeichner in input stimmen nicht überein.The hour component and the AM/PM designator in input do not agree.

Hinweise

Diese Methode analysiert eine Zeichen Spanne, die ein Datum darstellt, das mit einem der Muster übereinstimmt, die dem formats-Parameter zugewiesen sind.This method parses a character span representing a date that matches any one of the patterns assigned to the formats parameter. Wenn input keines dieser Muster mit einer der vom styles-Parameter definierten Variationen abstimmt, löst die Methode eine FormatExceptionaus.If input does not match any one of these patterns with any of the variations defined by the styles parameter, the method throws a FormatException. Abgesehen vom Vergleich von input mit mehreren Formatierungs Mustern verhält sich diese Überladung identisch mit der DateTimeOffset.ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)-Methode.Aside from comparing input to multiple formatting patterns, this overload behaves identically to the DateTimeOffset.ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, 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 das mögliche Muster des input-Parameters 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 the input parameter. Wenn die-Methode aufgerufen wird, muss input einem dieser Muster entsprechen.When the method is called, input must match one of these patterns. 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 Element in formats die z, zzoder zzz benutzerdefinierten Format Bearbeiter enthält, um anzugeben, dass ein Offset in inputvorhanden 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, löst die Methode eine FormatExceptionaus.If the sign is missing, the method throws a FormatException.

Wichtig

Wenn Sie den formats-Parameter dieser Überladung verwenden, um mehrere Formate anzugeben, können Sie die Frustration vieler Benutzer beim Eintreten von Datums-und Uhrzeitangaben verringern.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.

Wenn das übereinstimmende Element in formats erfordert, dass input ein Datum, aber keine Uhrzeit enthalten, wird dem resultierenden DateTimeOffset 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 Element in formats erfordert, dass input eine Uhrzeit, aber kein Datum enthalten, wird dem resultierenden DateTimeOffset 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 Element in formats nicht erfordert, dass input einen Offset enthalten, hängt der Offset des resultierenden DateTimeOffset 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 AssumeLocalenthä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 AssumeUniversalenthä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, die in input verwendet werden, werden durch den formatProvider-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 Format von input, wenn das übereinstimmende Element von formats eine standardmäßige formatspezifiziererzeichenfolge ist.The same is true for the precise format of input, if the matching element of formats is a standard format specifier string. Der formatProvider-Parameter kann eine der folgenden Optionen sein:The formatProvider parameter can be either of the following:

Wenn formatprovider nullist, wird das CultureInfo-Objekt verwendet, das der aktuellen Kultur entspricht.If 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 mit Ausnahme von 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 Analysiert input und konvertiert Sie ggf. in UTC.Parses input and, if necessary, converts it to UTC. Dies entspricht dem Durchlaufen einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime-Methode des zurückgegebenen DateTimeOffset Objekts.It is equivalent to parsing a string, and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AssumeLocal Wenn das übereinstimmende Element in formats nicht erfordert, dass input einen Offset Wert enthalten, wird dem zurückgegebenen DateTimeOffset 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 Element in formats nicht erfordert, dass input einen Offset Wert enthalten, erhält das zurückgegebene DateTimeOffset 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 Leerzeichen, die nicht durch formatangegeben werden.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 (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 the offset), and is ignored when parsing the string.
AllowLeadingWhite Ermöglicht input das Einschließen von führenden Leerzeichen, die nicht durch formatsangegeben werden.Allows input to include leading spaces not specified by 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 durch formatsangegeben werdenAllows input to include trailing spaces not specified by 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 durch formatsangegeben werden.Allows input to include leading, trailing, and inner spaces not specified by 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 wie in einem bestimmten Element von formats angegeben werden, damit eine Übereinstimmung auftritt.White space must appear exactly as specified in a particular element of formats for a match to occur. 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.

Gilt für: