DateTimeOffset.Parse Methode
Definition
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 einer Datums- und Uhrzeitangabe in die DateTimeOffset-Entsprechung.
Überlädt
Parse(String) |
Konvertiert die angegebene Zeichenfolgendarstellung einer Datums-, Uhrzeit- und Offsetangabe in die DateTimeOffset-Entsprechung. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analysiert eine Spanne von Zeichen in einen Wert. |
Parse(String, IFormatProvider) |
Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in den entsprechenden DateTimeOffset. |
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. |
Parse(String, IFormatProvider, DateTimeStyles) |
Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen und des Formatierungsstils in den entsprechenden DateTimeOffset. |
Hinweise
Wichtig
Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden. Weitere Informationen und informationen zum Ermitteln, ob Ihre Anwendungen betroffen sind, finden Sie unter Behandeln einer neuen Ära im japanischen Kalender in .NET. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für den Zeitwechsel sicherzustellen, finden Sie unter Vorbereiten ihrer Anwendung auf die Änderung der japanischen Ära. Features in .NET, die Kalender mit mehreren Epochen unterstützen, und bewährte Methoden für die Arbeit mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Epochen.
Parse(String)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Konvertiert die angegebene Zeichenfolgendarstellung einer Datums-, Uhrzeit- und Offsetangabe in die DateTimeOffset-Entsprechung.
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.
Gibt zurück
Ein Objekt, das mit der in input
enthaltenen Datums- und Uhrzeitangabe identisch ist.
Ausnahmen
Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.
input
ist null
.
input
enthält keine gültige Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe.
- 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 umfasst die Ausgabe vom 22. März 2007 für ein System, dessen Kultur en-us ist.
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 |
---|---|
<Date> | "2/10/2007" |
<Time> | "13:02:03" |
<Offset> | "-7:30" |
Obwohl jedes dieser Elemente optional ist, <kann Offset> nicht von selbst angezeigt werden. Sie muss zusammen mit <Datum> oder <Uhrzeit> bereitgestellt werden. Wenn <Date> fehlt, ist der Standardwert der aktuelle Tag. Wenn <Time> fehlt, ist der Standardwert 12:00:00 AM. Wenn <Date> vorhanden ist, die Jahreskomponente jedoch nur aus zwei Ziffern besteht, wird es im aktuellen Kalender der aktuellen Kultur basierend auf dem Wert der Calendar.TwoDigitYearMax Eigenschaft in ein Jahr konvertiert. Wenn <Offset> fehlt, ist sein Standardwert der Offset der lokalen Zeitzone. <Offset> kann entweder einen negativen oder einen positiven Offset aus koordinierter Weltzeit (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. Um eine Zeichenfolge zu analysieren, die eine angegebene Formatierung enthält, die nicht notwendigerweise der Formatierung der aktuellen Kultur entspricht, verwenden Sie die ParseExact -Methode, und geben Sie einen Formatbezeichner an.
Weitere Informationen
Gilt für:
Parse(ReadOnlySpan<Char>, IFormatProvider)
- 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
bereitstellt.
Gibt zurück
Das Ergebnis der Analyse s
von .
Implementiert
Gilt für:
Parse(String, IFormatProvider)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in den entsprechenden DateTimeOffset.
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 eine zu konvertierende Datums- und Zeitangabe enthält.
- formatProvider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatinformationen zu input
bereitstellt.
Gibt zurück
Ein Objekt, das der in input
enthaltenen Datums- und Uhrzeitangabe nach den Angaben von formatProvider
entspricht.
Implementiert
Ausnahmen
Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.
input
ist null
.
input
enthält keine gültige Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe.
- 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 standardmäßigen 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 sind in der folgenden Tabelle dargestellt.
Element | Beispiel |
---|---|
<Date> | "2/10/2007" |
<Time> | "13:02:03" |
<Offset> | "-7:30" |
Obwohl jedes dieser Elemente optional ist, <kann Offset> nicht von selbst angezeigt werden. Sie muss zusammen mit <Datum> oder <Uhrzeit> bereitgestellt werden. Wenn <Date> fehlt, ist der Standardwert der aktuelle Tag. Wenn <Date> vorhanden ist, seine Jahreskomponente jedoch nur aus zwei Ziffern besteht, wird es im aktuellen Kalender des provider
Parameters basierend auf dem Wert der Calendar.TwoDigitYearMax Eigenschaft in ein Jahr konvertiert. Wenn <Time> fehlt, ist der Standardwert 12:00:00 AM. Wenn <Offset> fehlt, ist sein Standardwert der Offset der lokalen Zeitzone.
<Offset> kann entweder einen negativen oder einen positiven Offset aus koordinierter Weltzeit (UTC) darstellen. In beiden Fällen <muss Offset> ein Zeichensymbol enthalten.
Das Format dieser drei Elemente wird durch den formatProvider
-Parameter definiert, der eines der folgenden Sein kann:
Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierung im
input
-Parameter verwendet wird. Das DateTimeFormatInfo von der CultureInfo.DateTimeFormat -Eigenschaft zurückgegebene -Objekt definiert die ininput
verwendete Formatierung.Ein DateTimeFormatInfo -Objekt, das das Format von Datums- und Uhrzeitdaten definiert.
Wenn formatprovider
ist null
, wird das CultureInfo Objekt verwendet, das der aktuellen Kultur entspricht.
Das positive oder negative Zeichen, das in <Offset verwendet wird,> muss entweder + oder -sein. Sie wird nicht durch die PositiveSign Eigenschaften oder NegativeSign des 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
Konvertiert die angegebene Spannendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen und des Formatierungsstils in den entsprechenden DateTimeOffset.
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 Zeichenspanne, die zu konvertierende Datums- und Uhrzeitwerte darstellt.
- formatProvider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatinformationen zu input
bereitstellt.
- styles
- DateTimeStyles
Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von input
angibt. Ein häufig angegebener Wert ist None.
Gibt zurück
Ein Objekt, das der in input
enthaltenen Datums- und Uhrzeitangabe nach den Angaben von formatProvider
und styles
entspricht.
Gilt für:
Parse(String, IFormatProvider, DateTimeStyles)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen und des Formatierungsstils in den entsprechenden DateTimeOffset.
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 eine zu konvertierende Datums- und Zeitangabe enthält.
- formatProvider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatinformationen zu input
bereitstellt.
- styles
- DateTimeStyles
Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von input
angibt. Ein häufig angegebener Wert ist None.
Gibt zurück
Ein Objekt, das der in input
enthaltenen Datums- und Uhrzeitangabe nach den Angaben von formatProvider
und styles
entspricht.
Ausnahmen
Der Offset ist größer als 14 Stunden oder kleiner als -14 Stunden.
- oder -
styles
ist kein gültiger DateTimeStyles -Wert.
- oder -
styles
beinhaltet einen nicht unterstützten DateTimeStyles-Wert.
- oder -
styles
enthält DateTimeStyles-Werte, die nicht zusammen verwendet werden können.
input
ist null
.
input
enthält keine gültige Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe.
- oder -
input
enthält die Zeichenfolgendarstellung eines Offsetwerts ohne Datum oder Uhrzeit.
Beispiele
Im folgenden Beispiel wird die Auswirkung der Übergabe der -, DateTimeStyles.AssumeUniversal- DateTimeStyles.AssumeLocalund DateTimeStyles.AdjustToUniversal -Werte an den styles
-Parameter 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
Diese Methode analysiert eine Zeichenfolge mit drei Elementen, die in beliebiger Reihenfolge angezeigt werden können und durch Leerzeichen getrennt sind. Diese drei Elemente sind in der folgenden Tabelle dargestellt.
Element | Beispiel |
---|---|
<Date> | "2/10/2007" |
<Time> | "13:02:03" |
<Offset> | "-7:30" |
Obwohl jedes dieser Elemente optional ist, <kann Offset> nicht von selbst angezeigt werden. Sie muss zusammen mit <Datum> oder <Uhrzeit> bereitgestellt werden. Wenn <Date> fehlt, ist der Standardwert der aktuelle Tag. Wenn <Date> vorhanden ist, seine Jahreskomponente jedoch nur aus zwei Ziffern besteht, wird es im aktuellen Kalender des provider
Parameters basierend auf dem Wert der Calendar.TwoDigitYearMax Eigenschaft in ein Jahr konvertiert. Wenn <Time> fehlt, ist der Standardwert 12:00:00 AM. Wenn <Offset> fehlt, ist sein Standardwert der Offset der lokalen Zeitzone, oder TimeSpan.Zero wenn entweder der DateTimeStyles.AdjustToUniversal Wert oder DateTimeStyles.AssumeUniversal im styles
-Parameter angegeben ist. Wenn <Offset> vorhanden ist, kann es entweder einen negativen oder einen positiven Offset aus der koordinierten Weltzeit (UTC) darstellen. In beiden Fällen <muss Offset> ein Zeichensymbol enthalten.
Das Format dieser drei Elemente wird durch den formatProvider
-Parameter definiert, der eines der folgenden Sein kann:
Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierung im
input
-Parameter verwendet wird. Das DateTimeFormatInfo von der CultureInfo.DateTimeFormat -Eigenschaft zurückgegebene -Objekt definiert die ininput
verwendete Formatierung.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 <Elemente Date> und <Time> können einen inneren Leerraum enthalten (z. B. 6: 00:00). Nur die <Offset-Komponente> kann keinen inneren Leerraum enthalten.
Wenn formatprovider
ist null
, wird das CultureInfo Objekt verwendet, das der aktuellen Kultur entspricht.
Das positive oder negative Zeichen, das in <Offset verwendet wird,> muss entweder + oder -sein. Sie wird nicht durch die PositiveSign Eigenschaften oder NegativeSign des Objekts definiert, das NumberFormatInfoformatProvider
vom -Parameter zurückgegeben wird.
In der folgenden Tabelle sind die Member der -Enumeration aufgeführt, die System.Globalization.DateTimeStyles unterstützt werden.
DateTimeStyles-Element | BESCHREIBUNG |
---|---|
AdjustToUniversal | Analysiert die durch input dargestellte Zeichenfolge und konvertiert sie bei Bedarf in UTC. Dies entspricht dem Analysieren einer Zeichenfolge und dem anschließenden Aufrufen der DateTimeOffset.ToUniversalTime -Methode des zurückgegebenen DateTimeOffset Objekts. |
AllowInnerWhite | Obwohl dieser Wert gültig ist, wird er ignoriert. Innere Leerzeichen sind in den <Elementen Date> und <Time> zulässig. |
AllowLeadingWhite | Obwohl dieser Wert gültig ist, wird er ignoriert. Führende Leerzeichen sind vor jeder Komponente in der analysierten Zeichenfolge zulässig. |
AllowTrailingWhite | Obwohl dieser Wert gültig ist, wird er ignoriert. Nachfolgende Leerzeichen sind vor jeder Komponente in der analysierten Zeichenfolge zulässig. |
AllowWhiteSpaces | Dies ist das Standardverhalten. Sie kann nicht durch Angabe eines restriktiveren DateTimeStyles Enumerationswerts DateTimeStyles.Nonewie überschrieben werden. |
AssumeLocal | Gibt an, dass, wenn dem input Parameter ein <Offset-Element> fehlt, der Offset der lokalen Zeitzone angegeben werden soll. Dies ist das Standardverhalten der Parse -Methode. |
AssumeUniversal | Gibt an, dass, wenn dem input Parameter kein <Offset-Element> fehlt, der UTC-Offset (00:00) angegeben werden soll. |
None | Obwohl dieser Wert gültig ist, wird er 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 wird ausgelöst, wenn dieser Wert im styles
Parameter enthalten ist.