DateTimeOffset.Parse Methode

Definition

Namespace:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in das DateTimeOffset entsprechende Format.

Überlädt

Name	Beschreibung
Parse(String)	Konvertiert die angegebene Zeichenfolgendarstellung eines Datums, einer Uhrzeit und eines Offsets in die DateTimeOffset entsprechende Zeichenfolge.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analysiert eine Spanne von Zeichen in einen Wert.
Parse(String, IFormatProvider)	Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen in das DateTimeOffset entsprechende Format um.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Wandelt die angegebene Spannweitendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen und Formatierungsformatvorlage in das DateTimeOffset entsprechende Format um.
Parse(String, IFormatProvider, DateTimeStyles)	Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen und Formatierungsformatvorlage in das DateTimeOffset entsprechende Format um.

Hinweise

Von Bedeutung

Ären in den japanischen Kalendern basieren auf der Herrschaft des Kaisers und werden daher voraussichtlich wechseln. Beispielsweise markierte der 1. Mai 2019 den Anfang der Reiwa-Ära in der JapaneseCalendar und JapaneseLunisolarCalendar. Eine solche Änderung des Zeitalters wirkt sich auf alle Anwendungen aus, die diese Kalender verwenden. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weitere Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für die Änderung der Ära sicherzustellen, finden Sie unter "Vorbereiten Ihrer Anwendung für die Änderung im japanischen Zeitalter". Features in .NET, die Kalender mit mehreren Epochen unterstützen und bewährte Methoden beim Arbeiten mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Eras.

Parse(String)

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums, einer Uhrzeit und eines Offsets in die DateTimeOffset entsprechende Zeichenfolge.

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 ein Datum und eine Uhrzeit enthält, die konvertiert werden soll.

Gibt zurück

DateTimeOffset

Ein Objekt, das dem Datum und der Uhrzeit entspricht, in inputdem enthalten ist.

Ausnahmen

ArgumentException

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.

ArgumentNullException

input ist null.

FormatException

input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.

- oder -

input enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.

Beispiele

Im folgenden Beispiel wird die Parse(String) Methode aufgerufen, um mehrere Datums- und Uhrzeitzeichenfolgen zu analysieren. Das Beispiel enthält die Ausgabe vom 22. März 2007 auf einem System, dessen Kultur en-usist.

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());

// String with date only
let dateString = "05/01/2008"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with time only
let dateString = "11:36 PM"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with date and offset
let dateString = "05/01/2008 +1:00"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with day abbreviation
let dateString = "Thu May 01, 2008"
let offsetDate = DateTimeOffset.Parse(dateString)
printfn $"{offsetDate}"

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) analysiert eine Zeichenfolge mit drei Elementen, die in beliebiger Reihenfolge angezeigt werden können und durch Leerzeichen getrennt sind. Diese drei Elemente sind wie in der folgenden Tabelle dargestellt.

Element	Beispiel
<Datum>	"2/10/2007"
<Zeit>	"1:02:03 Uhr"
<Offset>	"-7:30"

Obwohl jedes dieser Elemente optional ist, <kann offset> nicht selbst angezeigt werden. Sie muss zusammen mit <Datum> oder <Uhrzeit> bereitgestellt werden. Wenn <Datum> fehlt, ist der Standardwert der aktuelle Tag. Wenn <"Time> " fehlt, ist der Standardwert 12:00:00 Uhr. Wenn <Datum> vorhanden ist, die Jahreskomponente aber 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. Wenn <Offset> fehlt, ist der Standardwert der Offset der lokalen Zeitzone. <Offset> kann entweder einen negativen oder einen positiven Offset aus koordinierter Weltzeit (COORDINATED Universal Time, UTC) darstellen. In beiden Fällen <muss Offset> ein Zeichensymbol enthalten.

Die input Zeichenfolge wird mithilfe der Formatierungsinformationen in einem DateTimeFormatInfo Objekt analysiert, das für die aktuelle Kultur initialisiert wird. Verwenden Sie die ParseExact Methode, um eine Zeichenfolge zu analysieren, die bestimmte Formatierungen enthält, die nicht unbedingt der Formatierung der aktuellen Kultur entsprechen, und geben Sie einen Formatbezeichner an.

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider)

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Analysiert eine Spanne von Zeichen in einen Wert.

public:
 static DateTimeOffset Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<DateTimeOffset>::Parse;

public static DateTimeOffset Parse(ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> DateTimeOffset

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As DateTimeOffset

Parameter

s: ReadOnlySpan<Char>

Die Spanne der zu analysierenden Zeichen.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s.

Gibt zurück

DateTimeOffset

Das Ergebnis der Analyse s.

Implementiert

Parse(ReadOnlySpan<Char>, IFormatProvider)

Gilt für:

Parse(String, IFormatProvider)

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen in das DateTimeOffset entsprechende Format um.

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider);

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider) = IParsable<DateTimeOffset>::Parse;

public static DateTimeOffset Parse(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 ein Datum und eine Uhrzeit enthält, die konvertiert werden soll.

formatProvider: IFormatProvider

Ein Objekt, das kulturspezifische Formatinformationen zu input.

Gibt zurück

DateTimeOffset

Ein Objekt, das dem Datum und der Uhrzeit entspricht, das in input, wie angegeben, formatProviderenthalten ist.

Implementiert

Parse(String, IFormatProvider)

Ausnahmen

ArgumentException

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.

ArgumentNullException

input ist null.

FormatException

input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.

- oder -

input enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.

Beispiele

Im folgenden Beispiel werden Datums- und Uhrzeitzeichenfolgen analysiert, die für die fr-fr Kultur formatiert sind, und zeigt sie mithilfe der standard-en-us Kultur des lokalen Systems an.

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

let fmt = CultureInfo("fr-fr").DateTimeFormat
let dateString = "03-12-07"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

let dateString = "15/09/07 08:45:00 +1:00"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

let dateString = "mar. 1 janvier 2008 1:00:00 +1:00"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

// 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 getrennt sind. Diese drei Elemente werden in der folgenden Tabelle angezeigt.

Element	Beispiel
<Datum>	"2/10/2007"
<Zeit>	"1:02:03 Uhr"
<Offset>	"-7:30"

Obwohl jedes dieser Elemente optional ist, <kann offset> nicht selbst angezeigt werden. Sie muss zusammen mit <Datum> oder <Uhrzeit> bereitgestellt werden. Wenn <Datum> fehlt, ist der Standardwert der aktuelle Tag. Wenn <Datum> vorhanden ist, die Jahreskomponente aber 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. Wenn <"Time> " fehlt, ist der Standardwert 12:00:00 Uhr. Wenn <Offset> fehlt, ist der Standardwert der Offset der lokalen Zeitzone. <Offset> kann entweder einen negativen oder einen positiven Offset aus koordinierter Weltzeit (COORDINATED Universal Time, UTC) darstellen. In beiden Fällen <muss Offset> ein Zeichensymbol enthalten.

Das Format dieser drei Elemente wird durch den formatProvider Parameter definiert, der eine der folgenden Sein kann:

Ein CultureInfo Objekt, das die Kultur darstellt, deren Formatierung im input Parameter verwendet wird. Das von der Eigenschaft DateTimeFormatInfo zurückgegebene CultureInfo.DateTimeFormat Objekt definiert das in input verwendete Format.
Ein DateTimeFormatInfo Objekt, das das Format von Datums- und Uhrzeitdaten definiert.

Wenn formatprovider ja null, wird das CultureInfo Objekt verwendet, das der aktuellen Kultur entspricht.

Das positive oder negative Zeichen, das im <Offset> verwendet wird, muss +oder -sein. Sie wird nicht durch die PositiveSign Eigenschaften des NegativeSign NumberFormatInfo Objekts des formatProvider Parameters definiert.

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Wandelt die angegebene Spannweitendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen und Formatierungsformatvorlage in das DateTimeOffset entsprechende Format um.

public static DateTimeOffset Parse(ReadOnlySpan<char> input, IFormatProvider? formatProvider = default, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);

public static DateTimeOffset Parse(ReadOnlySpan<char> input, IFormatProvider formatProvider = default, 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 = Nothing, Optional styles As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTimeOffset

Parameter

input: ReadOnlySpan<Char>

Eine Spanne, die die Zeichen enthält, die ein zu konvertierende Datum und eine Uhrzeit darstellen.

formatProvider: IFormatProvider

Ein Objekt, das kulturspezifische Formatinformationen zu input.

styles: DateTimeStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von input. Ein typischer Wert, der angegeben werden soll, ist None.

Gibt zurück

DateTimeOffset

Ein Objekt, das dem Datum und der Uhrzeit entspricht, das in der angegebenen input Und-Uhrzeit stylesenthalten formatProvider ist.

Gilt für:

Parse(String, IFormatProvider, DateTimeStyles)

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Quelle:: DateTimeOffset.cs

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen und Formatierungsformatvorlage in das DateTimeOffset entsprechende Format um.

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);

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 ein Datum und eine Uhrzeit enthält, die konvertiert werden soll.

formatProvider: IFormatProvider

Ein Objekt, das kulturspezifische Formatinformationen zu input.

styles: DateTimeStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von input. Ein typischer Wert, der angegeben werden soll, ist None.

Gibt zurück

DateTimeOffset

Ein Objekt, das dem Datum und der Uhrzeit entspricht, das in der angegebenen input Und-Uhrzeit stylesenthalten formatProvider ist.

Ausnahmen

ArgumentException

Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.

- oder -

styles ist kein gültiger DateTimeStyles Wert.

- oder -

styles enthält einen nicht unterstützten DateTimeStyles Wert.

- oder -

styles enthält DateTimeStyles Werte, die nicht zusammen verwendet werden können.

ArgumentNullException

input ist null.

FormatException

input enthält keine gültige Zeichenfolgendarstellung eines Datums und einer Uhrzeit.

- oder -

input enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.

Beispiele

Im folgenden Beispiel wird der Effekt der Übergabe der DateTimeStyles.AssumeLocalWerte DateTimeStyles.AssumeUniversalund DateTimeStyles.AdjustToUniversalstyles des Parameters der Parse(String, IFormatProvider, DateTimeStyles) Methode veranschaulicht.

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

let dateString = "05/01/2008 6:00:00"
// Assume time is local
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal)
printfn $"{offsetDate}"   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal)
printfn $"{offsetDate}"   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC
let dateString = "05/01/2008 6:00:00AM +5:00"
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal)
printfn $"{offsetDate}"   // 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

Element	Beispiel
<Datum>	"2/10/2007"
<Zeit>	"1:02:03 Uhr"
<Offset>	"-7:30"

Obwohl jedes dieser Elemente optional ist, <kann offset> nicht selbst angezeigt werden. Sie muss zusammen mit <Datum> oder <Uhrzeit> bereitgestellt werden. Wenn <Datum> fehlt, ist der Standardwert der aktuelle Tag. Wenn <Datum> vorhanden ist, die Jahreskomponente aber 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. Wenn <"Time> " fehlt, ist der Standardwert 12:00:00 Uhr. Wenn <Offset> fehlt, ist der Standardwert der Offset der lokalen Zeitzone, oder TimeSpan.Zero wenn der DateTimeStyles.AdjustToUniversal DateTimeStyles.AssumeUniversal Wert im styles Parameter angegeben ist. Wenn <Offset> vorhanden ist, kann es entweder einen negativen oder einen positiven Offset aus koordinierter Weltzeit (COORDINATED Universal Time, UTC) darstellen. In beiden Fällen <muss Offset> ein Zeichensymbol enthalten.

Das Format dieser drei Elemente wird durch den formatProvider Parameter definiert, der eine der folgenden Sein kann:

Ein CultureInfo Objekt, das die Kultur darstellt, deren Formatierung im input Parameter verwendet wird. Das von der Eigenschaft DateTimeFormatInfo zurückgegebene CultureInfo.DateTimeFormat Objekt definiert das in input verwendete Format.
Ein DateTimeFormatInfo Objekt, das das Format von Datums- und Uhrzeitdaten definiert.

Jedes Element kann auch durch führende oder nachfolgende Leerzeichen eingeschlossen werden, und die <Datums> - und <Uhrzeitelemente> können innere Leerzeichen (z. B. 6: 00:00) enthalten. Nur die <Offset-Komponente> darf keinen internen Leerraum enthalten.

Wenn formatprovider ja null, wird das CultureInfo Objekt verwendet, das der aktuellen Kultur entspricht.

Das positive oder negative Zeichen, das im <Offset> verwendet wird, muss +oder -sein. Sie wird nicht durch die oder NegativeSign die PositiveSign Eigenschaften des Objekts definiert, das NumberFormatInfo vom formatProvider Parameter zurückgegeben wird.

In der folgenden Tabelle sind die Elemente der System.Globalization.DateTimeStyles unterstützten Aufzählung aufgeführt.

DateTimeStyles-Mitglied	Beschreibung
AdjustToUniversal	Analysiert die durch `input` und bei Bedarf dargestellte Zeichenfolge in UTC. Sie entspricht der Analyse einer Zeichenfolge und dem Anschließenden Aufrufen der DateTimeOffset.ToUniversalTime Methode des zurückgegebenen DateTimeOffset Objekts.
AllowInnerWhite	Obwohl gültig, wird dieser Wert ignoriert. Innerer Leerraum ist in den <Elementen "Date> " und <"Time> " zulässig.
AllowLeadingWhite	Obwohl gültig, wird dieser Wert ignoriert. Führende Leerzeichen sind vor jeder Komponente in der analysierten Zeichenfolge zulässig.
AllowTrailingWhite	Obwohl gültig, wird dieser Wert ignoriert. Nachfolgende Leerzeichen sind vor jeder Komponente in der analysierten Zeichenfolge zulässig.
AllowWhiteSpaces	Dies ist das Standardverhalten. Es kann nicht überschrieben werden, indem ein restriktiverer DateTimeStyles Enumerationswert bereitgestellt wird, z DateTimeStyles.None. B. .
AssumeLocal	Gibt an, dass, wenn der `input` Parameter kein <Offset-Element> enthält, der Offset der lokalen Zeitzone angegeben werden soll. Dies ist das Standardverhalten der Parse Methode.
AssumeUniversal	Gibt an, dass, wenn der `input` Parameter kein <Offset-Element> enthält, der UTC-Offset (00:00) angegeben werden soll.
None	Obwohl gültig, wird dieser Wert ignoriert und hat keine Auswirkung.
RoundtripKind	Da die DateTimeOffset Struktur keine Eigenschaft enthält `Kind` , hat dieser Wert keine Auswirkung.

Nur der DateTimeStyles.NoCurrentDateDefault Wert wird nicht unterstützt. Ein ArgumentException Fehler wird ausgelöst, wenn dieser Wert im styles Parameter enthalten ist.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

DateTimeOffset.Parse Methode

Definition

Überlädt

Hinweise

Parse(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Gilt für:

Parse(String, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Parameter

Gibt zurück

Gilt für:

Parse(String, IFormatProvider, DateTimeStyles)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback