DateTimeOffset.Parse Methode

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

Gibt zurück

Ausnahmen

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

• TryParse
• ParseExact

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

Gibt zurück

Ausnahmen

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:

• Ein CultureInfo-Objekt, das die Kultur darstellt, deren Formatierung im input-Parameter verwendet wird.A CultureInfo object that represents the culture whose formatting is used in the input parameter. Das von der CultureInfo.DateTimeFormat-Eigenschaft zurückgegebene DateTimeFormatInfo Objekt definiert die in inputverwendete Formatierung.The DateTimeFormatInfo object returned by the CultureInfo.DateTimeFormat property defines the formatting used in input.

• Ein DateTimeFormatInfo-Objekt, das das Format von Datums-und Uhrzeitdaten definiert.A DateTimeFormatInfo object that defines the format of date and time data.

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

• TryParse
• ParseExact

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

Gibt zurück

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

Gibt zurück

Ausnahmen

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:

• Ein CultureInfo-Objekt, das die Kultur darstellt, deren Formatierung im input-Parameter verwendet wird.A CultureInfo object that represents the culture whose formatting is used in the input parameter. Das von der CultureInfo.DateTimeFormat-Eigenschaft zurückgegebene DateTimeFormatInfo Objekt definiert die in inputverwendete Formatierung.The DateTimeFormatInfo object returned by the CultureInfo.DateTimeFormat property defines the formatting used in input.

• Ein DateTimeFormatInfo-Objekt, das das Format von Datums-und Uhrzeitdaten definiert.A DateTimeFormatInfo object that defines the format of date and time data.

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

• TryParse
• ParseExact