Elemento <EnableAmPmParseAdjustment>

Determina se os métodos de análise de data e hora usam um conjunto de regras ajustado para analisar sequências de datas que contêm um dia, mês, hora e designador AM/PM.

<configuration>
  <runtime>
    <EnableAmPmParseAdjustment>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
enabled Atributo obrigatório.

Especifica se os métodos de análise de data e hora usam um conjunto de regras ajustado para analisar sequências de datas que contêm somente um dia, mês, hora e designador AM/PM.

Atributo habilitado

Valor Descrição
0 Métodos de análise de data e hora não usam regras ajustadas para analisar sequências de datas que contêm somente um dia, mês, hora e designador AM/PM.
1 Métodos de análise de data e hora usam regras ajustadas para analisar sequências de datas que contêm somente um dia, mês, hora e designador AM/PM.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
runtime Contém informações sobre opções de inicialização do runtime.

Comentários

O elemento <EnableAmPmParseAdjustment> controla como os métodos a seguir analisam uma cadeia de caracteres de data que contém um dia e um mês numéricos seguidos por uma hora e um designador AM/PM (como "4/10 6 AM"):

Nenhum outro padrão é afetado.

O elemento <EnableAmPmParseAdjustment> não tem nenhum efeito sobre os métodos DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExact e DateTimeOffset.TryParseExact.

Importante

No .NET Core e no .NET Native, as regras ajustadas de análise AM/PM são habilitadas por padrão.

Se a regra de ajuste de análise não estiver habilitada, o primeiro dígito da cadeia de caracteres será interpretado como a hora do relógio de 12 horas e o restante da cadeia de caracteres, exceto para o designador AM/PM, será ignorado. A data e a hora retornadas pelo método de análise consistem na data atual e na hora do dia extraída da cadeia de caracteres de data.

Se a regra de ajuste de análise estiver habilitada, o método de análise interpretará o dia e o mês como pertencentes ao ano atual e interpretará a hora como a hora do relógio de 12 horas.

A tabela a seguir ilustra a diferença no valor DateTime quando o método DateTime.Parse(String) é usado para analisar a cadeia de caracteres ""4/10 6 AM" com a propriedade <EnableAmPmParseAdjustment> do elemento enabled definida como "0" ou "1". Ele pressupõe que a data de hoje seja 5 de janeiro de 2017 e exibe a data como se estivesse formatada usando a cadeia de caracteres de formato "G" da cultura especificada.

Nome da cultura habilitado="0" desabilitado="1"
pt-BR 5/1/2017 4:00:00 AM 10/4/2017 6:00:00 AM
en-GB 1/5/2017 6:00:00 4/10/2017 6:00:00

Confira também