<EnableAmPmParseAdjustment>-Element

  • Artikel

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

Siehe auch