Partilhar via


<EnableAmPmParseAdjustment> Elemento

Determina se os métodos de análise de data e hora utilizam um conjunto ajustado de regras para analisar cadeias de data que contenham um designador de dia, mês, hora e AM/PM.

<configuração>
   <tempo de execução>
     <EnableAmPmParseAdjustment>

Sintaxe

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

Atributos e Elementos

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

Attributes

Attribute Description
enabled Atributo obrigatório.

Especifica se os métodos de análise de data e hora utilizam um conjunto ajustado de regras para analisar cadeias de data que contenham apenas um designador de dia, mês, hora e AM/PM.

Atributo ativado

Valor Description
0 Os métodos de análise de data e hora não utilizam regras ajustadas para sequências de data que contenham apenas um designador de dia, mês, hora e AM/PM.
1 Os métodos de análise de data e hora utilizam regras ajustadas para a análise de cadeias de data que contêm apenas um designador de dia, mês, hora e AM/PM.

Elementos Subordinados

Nenhum.

Elementos Principais

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

Observações

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

Nenhum outro padrão é afetado.

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

Importante

No .NET Core e .NET Native, as regras ajustadas de análise sintática AM/PM estão ativadas por defeito.

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

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

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

Nome da cultura enabled="0" permitido="1"
en-US 05/01/2017 04:00:00 10/04/2017 6:00:00
en-GB 5/1/2017 6:00:00 10/4/2017 6:00:00

Consulte também