<EnableAmPmParseAdjustment>-Element
Legt fest, ob Analysemethoden für Datum und Uhrzeit einen angepassten Satz von Regeln zum Parsen von Datumszeichenfolgen verwenden, die Angaben zu Tag, Monat, Stunde oder einen AM/PM-Kennzeichner enthalten.
<configuration>
<runtime>
<EnableAmPmParseAdjustment>
Syntax
<EnableAmPmParseAdjustment enabled="0"|"1" />
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
| attribute | Beschreibung |
|---|---|
enabled |
Erforderliches Attribut. Legt fest, ob Analysemethoden für Datum und Uhrzeit einen angepassten Satz von Regeln zum Parsen von Datumszeichenfolgen verwenden, die nur Angaben zu Tag, Monat, Stunde oder einen AM/PM-Kennzeichner enthalten. |
Enabled-Attribut
| Wert | Beschreibung |
|---|---|
| 0 | Datums- und Uhrzeitanalysemethoden verwenden keine angepassten Regeln zum Parsen von Datumszeichenfolgen, die nur Angaben zu Tag, Monat, Stunde oder einen AM/PM-Kennzeichner enthalten. |
| 1 | Datums- und Uhrzeitanalysemethoden verwenden angepasste Regeln zum Parsen von Datumszeichenfolgen, die nur Angaben zu Tag, Monat, Stunde oder einen AM/PM-Kennzeichner enthalten. |
Untergeordnete Elemente
Keine
Übergeordnete Elemente
| Element | BESCHREIBUNG |
|---|---|
configuration |
Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei. |
runtime |
Enthält Informationen über Laufzeitinitialisierungsoptionen. |
Bemerkungen
Das <EnableAmPmParseAdjustment>-Element steuert, wie die folgenden Methoden eine Datumszeichenfolge parsen, die einen numerischen Tag und Monat gefolgt von einer Stunde und einen AM/PM-Kennzeichner (z. B. „4/10 6 AM“) enthalten.
Es sind keine anderen Muster betroffen.
Das <EnableAmPmParseAdjustment>-Element hat keine Auswirkungen auf die Methoden DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExact und DateTimeOffset.TryParseExact.
Wichtig
In .NET Core und .NET Native sind die angepassten AM/PM-Analyseregeln standardmäßig aktiviert.
Wenn die Analyseanpassungsregel nicht aktiviert ist, wird die erste Ziffer der Zeichenfolge als Stunde der 12-Stunden-Uhr interpretiert, und der Rest der Zeichenfolge mit Ausnahme des AM/PM-Entwurfs wird ignoriert. Das von der Analysemethode zurückgegebene Datum und die Uhrzeit bestehen aus dem aktuellen Datum und der Stunde des Tages, die aus der Datumszeichenfolge extrahiert wurden.
Wenn die Analyseanpassungsregel aktiviert ist, interpretiert die Analysemethode den Tag und Monat als zum aktuellen Jahr gehörend und interpretiert die Zeit als Stunde der 12-Stunden-Uhr.
Die folgende Tabelle veranschaulicht den Unterschied im DateTime-Wert, wenn die DateTime.Parse(String)-Methode verwendet wird, um die Zeichenfolge „4/10 6 AM“ zu parsen, wobei die enabled-Eigenschaft des <EnableAmPmParseAdjustment>-Elements auf „0“ oder „1“ festgelegt ist. Es wird davon ausgegangen, dass das heutige Datum der 5. Januar 2017 ist. Das Datum wird angezeigt, als wäre es mit der Formatzeichenfolge „G“ der angegebenen Kultur formatiert.
| Kulturname | enabled="0" | enabled="1" |
|---|---|---|
| de-DE | 1/5/2017 4:00:00 AM | 4/10/2017 6:00:00 AM |
| en-GB | 5/1/2017 6:00:00 | 10/4/2017 6:00:00 |
