DateTimeOffset.Parse 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.

Überlädt

Parse(String)

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums, einer Uhrzeit und eines Offsets in den entsprechenden DateTimeOffset.Converts the specified string representation of a date, time, and offset to its DateTimeOffset equivalent.

Parse(String, IFormatProvider)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung 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 culture-specific format information.

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Konvertiert die angegebene Spannendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen und des Formatierungsstils in den entsprechenden DateTimeOffset.Converts the specified span representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.

Parse(String, IFormatProvider, DateTimeStyles)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen und des Formatierungsstils in die entsprechende DateTimeOffset.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.

Hinweise

Wichtig

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

Parse(String)

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums, einer Uhrzeit und eines Offsets in den entsprechenden DateTimeOffset.Converts the specified string representation of a date, time, and offset to its DateTimeOffset equivalent.

public:
 static DateTimeOffset Parse(System::String ^ input);
public static DateTimeOffset Parse (string input);
static member Parse : string -> DateTimeOffset
Public Shared Function Parse (input As String) 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.

Gibt zurück

Ein Objekt, das mit der in input enthaltenen Datums- und Uhrzeitangabe identisch ist.An object that is equivalent to the date and time that is contained in input.

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.

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

- oder --or- input enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.input contains the string representation of an offset value without a date or time.

Beispiele

Im folgenden Beispiel wird die Parse(String)-Methode aufgerufen, um mehrere Datums-und Uhrzeit Zeichenfolgen zu analysieren.The following example calls the Parse(String) method to parse several date and time strings. Das Beispiel enthält die Ausgabe vom 22. März 2007 in einem System, dessen Kultur en-US ist.The example includes output from March 22, 2007, on a system whose culture is en-us.

string dateString;
DateTimeOffset offsetDate; 

// String with date only
dateString = "05/01/2008";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with time only
dateString = "11:36 PM";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with date and offset 
dateString = "05/01/2008 +1:00";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with day abbreviation
dateString = "Thu May 01, 2008";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());
Dim dateString As String
Dim offsetDate As DateTimeOffset

' String with date only
dateString = "05/01/2008"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM -07:00  

' String with time only
dateString = "11:36 PM"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 3/26/2007 11:36:00 PM -07:00

' String with date and offset 
dateString = "05/01/2008 +7:00"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM +07:00

' String with day abbreviation
dateString = "Thu May 01, 2008"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM -07:00

Hinweise

Parse(String) eine Zeichenfolge mit drei Elementen analysiert, die in beliebiger Reihenfolge angezeigt werden können und durch Leerzeichen getrennt sind.Parse(String) parses a string with three elements that can appear in any order and are delimited by white space. Diese drei Elemente sind wie in der folgenden Tabelle dargestellt.These three elements are as shown in the following table.

ElementElement BeispielExample
<Datum ><Date> "2/10/2007""2/10/2007"
<Zeit ><Time> "1:02:03 Uhr""1:02:03 PM"
<Offset ><Offset> "-7:30""-7:30"

Obwohl jedes dieser Elemente optional ist, kann <Offset > nicht allein angezeigt werden.Although each of these elements is optional, <Offset> cannot appear by itself. Es muss entweder <Datum > oder <Zeit > bereitgestellt werden.It must be provided together with either <Date> or <Time>. Wenn <Datum > fehlt, ist der Standardwert der aktuelle Tag.If <Date> is missing, its default value is the current day. Wenn <Zeit > fehlt, ist der Standardwert 12:00:00 Uhr.If <Time> is missing, its default value is 12:00:00 AM. Wenn <Date > vorhanden ist, die Jahr Komponente jedoch nur aus zwei Ziffern besteht, wird Sie basierend auf dem Wert der Calendar.TwoDigitYearMax-Eigenschaft in ein Jahr im aktuellen Kalender der aktuellen Kultur konvertiert.If <Date> is present but its year component consists of only two digits, it is converted to a year in the current culture's current calendar based on the value of the Calendar.TwoDigitYearMax property. Wenn <Offset > fehlt, ist der Standardwert der Offset der lokalen Zeitzone.If <Offset> is missing, its default value is the offset of the local time zone. <Offset > kann entweder eine negative oder eine positive Abweichung von der koordinierten Weltzeit (UTC) darstellen.<Offset> can represent either a negative or a positive offset from Coordinated Universal Time (UTC). In beiden Fällen muss <Offset > ein Vorzeichen Symbol enthalten.In either case, <Offset> must include a sign symbol.

Die input Zeichenfolge wird mithilfe der Formatierungsinformationen in einem DateTimeFormatInfo-Objekt analysiert, das für die aktuelle Kultur initialisiert wird.The input string is parsed by using the formatting information in a DateTimeFormatInfo object that is initialized for the current culture. Verwenden Sie die ParseExact-Methode, und geben Sie einen Format Bezeichner an, um eine Zeichenfolge zu analysieren, die die festgelegte Formatierung enthält, die nicht notwendigerweise der Formatierung der aktuellen Kultur entspricht.To parse a string that contains designated formatting that does not necessarily correspond to the formatting of the current culture, use the ParseExact method and provide a format specifier.

Siehe auch

Parse(String, IFormatProvider)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung 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 culture-specific format information.

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider);
public static DateTimeOffset Parse (string input, IFormatProvider formatProvider);
static member Parse : string * IFormatProvider -> DateTimeOffset
Public Shared Function Parse (input As String, formatProvider As IFormatProvider) 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.

formatProvider
IFormatProvider

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

Gibt zurück

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

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

- oder --or- input enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.input contains the string representation of an offset value without a date or time.

Beispiele

Im folgenden Beispiel werden Datums-und Uhrzeit Zeichenfolgen, die für die Kultur "fr-FR" formatiert sind, analysiert und mithilfe der Standard Kultur "en-US" des lokalen Systems angezeigt.The following example parses date and time strings that are formatted for the fr-fr culture and displays them using the local system's default en-us culture.

DateTimeFormatInfo fmt = new CultureInfo("fr-fr").DateTimeFormat;
string dateString;
DateTimeOffset offsetDate;

dateString = "03-12-07";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}", 
                  dateString, 
                  offsetDate.ToString());

dateString = "15/09/07 08:45:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}", 
                  dateString, 
                  offsetDate.ToString());

dateString = "mar. 1 janvier 2008 1:00:00 +1:00"; 
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}", 
                  dateString, 
                  offsetDate.ToString());
// The example displays the following output to the console:
//    03-12-07 returns 12/3/2007 12:00:00 AM -08:00
//    15/09/07 08:45:00 +1:00 returns 9/15/2007 8:45:00 AM +01:00
//    mar. 1 janvier 2008 1:00:00 +1:00 returns 1/1/2008 1:00:00 AM +01:00                              
Dim fmt As DateTimeFormatInfo = New CultureInfo("fr-fr").DateTimeFormat
Dim dateString As String
Dim offsetDate As DateTimeOffset

dateString = "03-12-07"
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())

dateString = "15/09/07 08:45:00 +1:00"
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())

dateString = "mar. 1 janvier 2008 1:00:00 +1:00" 
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())
' The example displays the following output to the console:
'    03-12-07 returns 12/3/2007 12:00:00 AM -08:00
'    15/09/07 08:45:00 +1:00 returns 9/15/2007 8:45:00 AM +01:00
'    mar. 1 janvier 2008 1:00:00 +1:00 returns 1/1/2008 1:00:00 AM +01:00                              

Hinweise

Diese Methode analysiert eine Zeichenfolge mit drei Elementen, die in beliebiger Reihenfolge angezeigt werden können und durch Leerzeichen voneinander getrennt sind.This method parses a string with three elements that can appear in any order and are delimited by white space. Diese drei Elemente sind in der folgenden Tabelle dargestellt.These three elements are shown in the following table.

ElementElement BeispielExample
<Datum ><Date> "2/10/2007""2/10/2007"
<Zeit ><Time> "1:02:03 Uhr""1:02:03 PM"
<Offset ><Offset> "-7:30""-7:30"

Obwohl jedes dieser Elemente optional ist, kann <Offset > nicht allein angezeigt werden.Although each of these elements is optional, <Offset> cannot appear by itself. Es muss entweder <Datum > oder <Zeit > bereitgestellt werden.It must be provided together with either <Date> or <Time>. Wenn <Datum > fehlt, ist der Standardwert der aktuelle Tag.If <Date> is missing, its default value is the current day. Wenn <Date > vorhanden ist, die Jahres Komponente jedoch nur aus zwei Ziffern besteht, wird Sie basierend auf dem Wert der Calendar.TwoDigitYearMax Eigenschaft in ein Jahr im aktuellen Kalender des provider Parameters konvertiert.If <Date> is present but its year component consists of only two digits, it is converted to a year in the provider parameter's current calendar based on the value of the Calendar.TwoDigitYearMax property. Wenn <Zeit > fehlt, ist der Standardwert 12:00:00 Uhr.If <Time> is missing, its default value is 12:00:00 AM. Wenn <Offset > fehlt, ist der Standardwert der Offset der lokalen Zeitzone.If <Offset> is missing, its default value is the offset of the local time zone. <Offset > kann entweder eine negative oder eine positive Abweichung von der koordinierten Weltzeit (UTC) darstellen.<Offset> can represent either a negative or a positive offset from Coordinated Universal Time (UTC). In beiden Fällen muss <Offset > ein Vorzeichen Symbol enthalten.In either case, <Offset> must include a sign symbol.

Das Format dieser drei Elemente wird durch den formatProvider-Parameter definiert, der einen der folgenden Elemente aufweisen kann:The format of these three elements is defined by the formatProvider parameter, which 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.

Das positive oder negative Vorzeichen, das in <Offset > verwendet wird, muss entweder + oder-sein.The positive or negative sign used in <Offset> must be either + or -. Sie wird nicht durch die Eigenschaften PositiveSign oder NegativeSign des NumberFormatInfo-Objekts des formatProvider-Parameters definiert.It is not defined by the PositiveSign or NegativeSign properties of the NumberFormatInfo object of the formatProvider parameter.

Siehe auch

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Konvertiert die angegebene Spannendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen und des Formatierungsstils in den entsprechenden DateTimeOffset.Converts the specified span representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.

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

Parameter

input
ReadOnlySpan<Char>

Eine Zeichenspanne, die zu konvertierende Datums- und Uhrzeitwerte darstellt.A span containing the characters that represent a date and time to convert.

formatProvider
IFormatProvider

Ein Objekt, das kulturspezifische Formatinformationen zu input bereitstellt.An object that provides culture-specific format 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. Ein häufig angegebener Wert ist None.A typical value to specify is None.

Gibt zurück

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

Parse(String, IFormatProvider, DateTimeStyles)

Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen und des Formatierungsstils in die entsprechende DateTimeOffset.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles);
public static DateTimeOffset Parse (string input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles);
static member Parse : string * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset
Public Shared Function Parse (input 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.

formatProvider
IFormatProvider

Ein Objekt, das kulturspezifische Formatinformationen zu input bereitstellt.An object that provides culture-specific format 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. Ein häufig angegebener Wert ist None.A typical value to specify is None.

Gibt zurück

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

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 ist kein gültiger DateTimeStyles -Wert.styles is not a valid DateTimeStyles value.

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

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

input ist null.input is null.

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

- oder --or- input enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.input contains the string representation of an offset value without a date or time.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Werte DateTimeStyles.AssumeLocal, DateTimeStyles.AssumeUniversalund DateTimeStyles.AdjustToUniversal an den styles-Parameter der Parse(String, IFormatProvider, DateTimeStyles)-Methode übergeben werden.The following example illustrates the effect of passing the DateTimeStyles.AssumeLocal, DateTimeStyles.AssumeUniversal, and DateTimeStyles.AdjustToUniversal values to the styles parameter of the Parse(String, IFormatProvider, DateTimeStyles) method.

string dateString;
DateTimeOffset offsetDate;

dateString = "05/01/2008 6:00:00";
// Assume time is local 
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC 
dateString = "05/01/2008 6:00:00AM +5:00";
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 1:00:00 AM +00:00
Dim dateString As String
Dim offsetDate As DateTimeOffset

dateString = "05/01/2008 6:00:00"
' Assume time is local 
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AssumeLocal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 6:00:00 AM -07:00

' Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AssumeUniversal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 6:00:00 AM +00:00

' Parse and convert to UTC 
dateString = "05/01/2008 6:00:00AM +5:00"
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AdjustToUniversal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 1:00:00 AM +00:00

Hinweise

Diese Methode analysiert eine Zeichenfolge mit drei Elementen, die in beliebiger Reihenfolge angezeigt werden können und durch Leerzeichen voneinander getrennt sind.This method parses a string with three elements that can appear in any order and are delimited by white space. Diese drei Elemente sind in der folgenden Tabelle dargestellt.These three elements are shown in the following table.

ElementElement BeispielExample
<Datum ><Date> "2/10/2007""2/10/2007"
<Zeit ><Time> "1:02:03 Uhr""1:02:03 PM"
<Offset ><Offset> "-7:30""-7:30"

Obwohl jedes dieser Elemente optional ist, kann <Offset > nicht allein angezeigt werden.Although each of these elements is optional, <Offset> cannot appear by itself. Es muss entweder <Datum > oder <Zeit > bereitgestellt werden.It must be provided together with either <Date> or <Time>. Wenn <Datum > fehlt, ist der Standardwert der aktuelle Tag.If <Date> is missing, its default value is the current day. Wenn <Date > vorhanden ist, die Jahres Komponente jedoch nur aus zwei Ziffern besteht, wird Sie basierend auf dem Wert der Calendar.TwoDigitYearMax Eigenschaft in ein Jahr im aktuellen Kalender des provider Parameters konvertiert.If <Date> is present but its year component consists of only two digits, it is converted to a year in the provider parameter's current calendar based on the value of the Calendar.TwoDigitYearMax property. Wenn <Zeit > fehlt, ist der Standardwert 12:00:00 Uhr.If <Time> is missing, its default value is 12:00:00 AM. Wenn <Offset > fehlt, ist der Standardwert der Offset der lokalen Zeitzone oder TimeSpan.Zero, wenn der Wert für DateTimeStyles.AdjustToUniversal oder DateTimeStyles.AssumeUniversal im styles Parameter angegeben wird.If <Offset> is missing, its default value is the offset of the local time zone, or TimeSpan.Zero if either the DateTimeStyles.AdjustToUniversal or DateTimeStyles.AssumeUniversal value is specified in the styles parameter. Wenn <Offset > vorhanden ist, kann Sie entweder einen negativen oder einen positiven Offset von der koordinierten Weltzeit (UTC) darstellen.If <Offset> is present, it can represent either a negative or a positive offset from Coordinated Universal Time (UTC). In beiden Fällen muss <Offset > ein Vorzeichen Symbol enthalten.In either case, <Offset> must include a sign symbol.

Das Format dieser drei Elemente wird durch den formatProvider-Parameter definiert, der einen der folgenden Elemente aufweisen kann:The format of these three elements is defined by the formatProvider parameter, which can be either of the following:

Jedes Element kann auch durch führende oder nachfolgende Leerzeichen eingeschlossen werden, und die <Datums > und <Zeit > Elemente können innere Leerräume (z. b. 6:00:00) enthalten.Each element can also be enclosed by leading or trailing white space, and the <Date> and <Time> elements can include inner white space (such as 6: 00:00). Nur die <Offset > Komponente darf keine inneren Leerräume enthalten.Only the <Offset> component cannot include inner white space.

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.

Das positive oder negative Vorzeichen, das in <Offset > verwendet wird, muss entweder + oder-sein.The positive or negative sign used in <Offset> must be either + or -. Sie wird nicht durch die Eigenschaften PositiveSign oder NegativeSign des NumberFormatInfo Objekts definiert, das vom formatProvider-Parameter zurückgegeben wird.It is not defined by the PositiveSign or NegativeSign properties of the NumberFormatInfo object returned by the formatProvider parameter.

In der folgenden Tabelle werden die Elemente der unterstützten System.Globalization.DateTimeStyles Enumeration aufgeführt.The following table shows the members of the System.Globalization.DateTimeStyles enumeration that are supported.

DateTimeStyles-MemberDateTimeStyles member BeschreibungDescription
AdjustToUniversal Analysiert die durch input dargestellte Zeichenfolge und konvertiert Sie ggf. in UTC.Parses the string represented by 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ückgegebenen DateTimeOffset Objekts.It is equivalent to parsing a string and then calling the DateTimeOffset.ToUniversalTime method of the returned DateTimeOffset object.
AllowInnerWhite Obwohl der Wert gültig ist, wird dieser Wert ignoriert.Although valid, this value is ignored. Innere Leerräume sind in den <Datums > und <Zeit > Elementen zulässig.Inner white space is permitted in the <Date> and <Time> elements.
AllowLeadingWhite Obwohl der Wert gültig ist, wird dieser Wert ignoriert.Although valid, this value is ignored. Vor jeder Komponente in der analysierten Zeichenfolge sind führende Leerzeichen zulässig.Leading white space is permitted in front of each component in the parsed string.
AllowTrailingWhite Obwohl der Wert gültig ist, wird dieser Wert ignoriert.Although valid, this value is ignored. Nachfolgende Leerzeichen sind vor jeder Komponente in der analysierten Zeichenfolge zulässig.Trailing white space is permitted in front of each component in the parsed string.
AllowWhiteSpaces Dies ist das Standardverhalten.This is the default behavior. Sie kann nicht überschrieben werden, indem eine restriktivere DateTimeStyles Enumerationswert bereitgestellt wird, z. b. DateTimeStyles.None.It cannot be overridden by supplying a more restrictive DateTimeStyles enumeration value, such as DateTimeStyles.None.
AssumeLocal Gibt an, dass der Offset der lokalen Zeitzone angegeben werden soll, wenn dem input-Parameter ein <Offset >-Element fehlt.Indicates that, if the input parameter lacks an <Offset> element, the offset of the local time zone should be provided. Dies ist das Standardverhalten der Parse-Methode.This is the default behavior of the Parse method.
AssumeUniversal Gibt an, dass der UTC-Offset (00:00) bereitgestellt werden soll, wenn dem input-Parameter kein <Offset >-Element fehlt.Indicates that, if the input parameter lacks an <Offset> element, the UTC offset (00:00) should be provided.
None Obwohl der Wert gültig ist, wird dieser Wert ignoriert und hat keine Auswirkungen.Although valid, this value is ignored and has no effect.
RoundtripKind Da die DateTimeOffset Struktur keine Kind-Eigenschaft enthält, hat dieser Wert keine Auswirkung.Because the DateTimeOffset structure does not include a Kind property, this value has no effect.

Nur der DateTimeStyles.NoCurrentDateDefault-Wert wird nicht unterstützt.Only the DateTimeStyles.NoCurrentDateDefault value is not supported. Eine ArgumentException wird ausgelöst, wenn dieser Wert im styles-Parameter enthalten ist.An ArgumentException is thrown if this value is included in the styles parameter.

Siehe auch

Gilt für: