Partilhar via


<EnableAmPmParseAdjustment Element (Elemento EnableAmPmParseAdjustment> )

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

<configuração>
  <runtime>
    <EnableAmPmParseAdjustment>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
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 contêm apenas um dia, mês, hora e designador AM/PM.

Atributo ativado

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

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
configuration O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações.
runtime Contém informações sobre as opções de inicialização do runtime.

Observações

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

Não são afetados outros padrões.

O <EnableAmPmParseAdjustment> elemento não tem qualquer efeito nos DateTime.ParseExactmétodos , DateTime.TryParseExact, DateTimeOffset.ParseExacte DateTimeOffset.TryParseExact .

Importante

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

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

Se a regra de ajuste de análise estiver ativada, 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 seguinte ilustra a diferença no DateTime valor quando o DateTime.Parse(String) método é utilizado 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 com a cadeia de formato "G" da cultura especificada.

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

Ver também