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 |
