Partager via

<EnableAmPmParseAdjustment>, élément

  • Article

Détermine si les méthodes d’analyse de la date et de l’heure utilisent un ensemble de règles ajusté pour analyser les chaînes de date qui contiennent un jour, un mois, une heure et un indicateur AM/PM.

<configuration>
  <runtime>
    <EnableAmPmParseAdjustment>

Syntaxe

<EnableAmPmParseAdjustment enabled="0"|"1" />

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
enabled Attribut requis.

Détermine si les méthodes d’analyse de la date et de l’heure utilisent un ensemble de règles ajusté pour analyser des chaînes de date qui contiennent uniquement un jour, un mois, une heure et un indicateur AM/PM.

Attribut enabled

Valeur Description
0 Les méthodes d’analyse de la date et de l’heure n’utilisent pas de règles ajustées pour analyser les chaînes de date qui contiennent uniquement un jour, un mois, une heure et un indicateur AM/PM.
1 Les méthodes d’analyse de la date et de l’heure utilisent des règles ajustées pour analyser les chaînes de date qui contiennent uniquement un jour, un mois, une heure et un indicateur AM/PM.

Éléments enfants

Aucune.

Éléments parents

Élément Description
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
runtime Contient des informations sur les options d'initialisation du runtime.

Notes

L’élément <EnableAmPmParseAdjustment> contrôle la façon dont les méthodes suivantes analysent une chaîne de date qui contient un jour et un mois numériques suivis d’une heure et d’un indicateur AM/PM (par exemple, « 4/10 6 AM ») :

Aucun autre modèle n’est affecté.

L’élément <EnableAmPmParseAdjustment> n’a aucun effet sur les méthodes DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExact et DateTimeOffset.TryParseExact.

Important

Dans .NET Core et .NET Native, les règles d’analyse AM/PM ajustées sont activées par défaut.

Si la règle d’ajustement d’analyse n’est pas activée, le premier chiffre de la chaîne est interprété comme étant l’heure de l’horloge de 12 heures, et le reste de la chaîne est ignoré à l’exception de l’indicateur AM/PM. La date et l’heure retournées par la méthode d’analyse se composent de la date actuelle et de l’heure du jour extraite de la chaîne de date.

Si la règle d’ajustement d’analyse est activée, la méthode d’analyse interprète le jour et le mois comme appartenant à l’année actuelle, et interprète l’heure comme étant heure de l’horloge de 12 heures.

Le tableau suivant illustre la différence au niveau de la valeur DateTime quand la méthode DateTime.Parse(String) est utilisée pour analyser la chaîne « 4/10 6 AM » et que la propriété enabled de l’élément <EnableAmPmParseAdjustment> est définie sur « 0 » ou « 1 ». La date du jour est ici le 5 janvier 2017 ; elle s’affiche comme si elle était mise en forme avec la chaîne de format « G » de la culture spécifiée.

Nom de culture enabled="0" enabled="1"
fr-FR 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

Voir aussi