Elemento <EnableAmPmParseAdjustment>

  • Artículo

Determina si los métodos de análisis de fecha y hora usan un conjunto ajustado de reglas para analizar cadenas de fecha que contienen un día, mes, hora y designador AM/PM.

<configuration>
  <runtime>
    <EnableAmPmParseAdjustment>

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
enabled Atributo necesario.

Especifica si los métodos de análisis de fecha y hora usan un conjunto ajustado de reglas para analizar cadenas de fecha que contienen solo un día, mes, hora y designador AM/PM.

Atributo enabled

Valor Descripción
0 Los métodos de análisis de fecha y hora no utilizan reglas ajustadas para analizar cadenas de fecha que contienen solo un día, mes, hora y designador AM/PM.
1 Los métodos de análisis de fecha y hora utilizan reglas ajustadas para analizar cadenas de fecha que contienen solo un día, mes, hora y designador AM/PM.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
runtime Contiene información sobre las opciones de inicialización del motor en tiempo de ejecución.

Comentarios

El elemento <EnableAmPmParseAdjustment> controla cómo los métodos siguientes analizan una cadena de fecha que contiene un día numérico y un mes seguidos de una hora y un designador am/PM (como "4/10 6 AM"):

Otros patrones no se ven afectados.

El elemento <EnableAmPmParseAdjustment> no tiene ningún efecto en los métodos DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExacty DateTimeOffset.TryParseExact.

Importante

En .NET Core y .NET Native, las reglas de análisis de AM/PM ajustadas están habilitadas de forma predeterminada.

Si la regla de ajuste de análisis no está habilitada, el primer dígito de la cadena se interpreta como la hora del reloj de 12 horas y se omite el resto de la cadena, excepto el designador AM/PM. La fecha y hora devueltas por el método de análisis consta de la fecha actual y la hora del día extraída de la cadena de fecha.

Si la regla de ajuste de análisis está habilitada, el método de análisis interpreta el día y el mes como perteneciente al año actual e interpreta la hora como la hora del reloj de 12 horas.

En la tabla siguiente se muestra la diferencia en el valor DateTime cuando se usa el método DateTime.Parse(String) para analizar la cadena ""4/10 6 AM" con la propiedad enabled del elemento <EnableAmPmParseAdjustment> establecida en "0" o "1". Se supone que la fecha de hoy es el 5 de enero de 2017 y muestra la fecha como si tuviera formato mediante la cadena de formato "G" de la referencia cultural especificada.

Nombre de referencia cultural 0=habilitado 1=habilitado
es-ES 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

Consulte también