DateTimeStyles Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define as opções de formatação que personalizam a análise de strings para alguns métodos de análise de data e hora.
Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.
public enum class DateTimeStyles[System.Flags]
public enum DateTimeStyles[System.Flags]
[System.Serializable]
public enum DateTimeStyles[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum DateTimeStyles[<System.Flags>]
type DateTimeStyles = [<System.Flags>]
[<System.Serializable>]
type DateTimeStyles = [<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeStyles = Public Enum DateTimeStyles- Herança
- Atributos
Campos
| Name | Valor | Description |
|---|---|---|
| None | 0 | Devem ser usadas opções de formatação padrão. Este valor representa o estilo padrão para os Parse(String)métodos , ParseExact(String, String, IFormatProvider), e TryParse(String, DateTime) . |
| AllowLeadingWhite | 1 | Os caracteres de espaço em branco iniciais devem ser ignorados durante a análise sintática, exceto se ocorrerem nos padrões de DateTimeFormatInfo formato. |
| AllowTrailingWhite | 2 | Os caracteres de espaço em branco finais devem ser ignorados durante a análise sintática, exceto se ocorrerem nos padrões de DateTimeFormatInfo formato. |
| AllowInnerWhite | 4 | Caracteres de espaço em branco extra no meio da cadeia devem ser ignorados durante a análise sintática, exceto se ocorrerem nos padrões de DateTimeFormatInfo formato. |
| AllowWhiteSpaces | 7 | Caracteres em branco extra em qualquer parte da cadeia devem ser ignorados durante a análise sintática, exceto se ocorrerem nos padrões de DateTimeFormatInfo formato. Este valor é uma combinação dos AllowLeadingWhitevalores , AllowTrailingWhite, e AllowInnerWhite . |
| NoCurrentDateDefault | 8 | Se a cadeia analisada contiver apenas a hora e não a data, os métodos de análise sintática assumem a data gregoriana com ano = 1, mês = 1 e dia = 1. Se este valor não for utilizado, assume-se a data atual. |
| AdjustToUniversal | 16 | A data e a hora são devolvidas como um Tempo Universal Coordenado (UTC). Se a cadeia de entrada indicar uma hora local, através de um especificador de fuso horário ou AssumeLocal, a data e hora são convertidas da hora local para UTC. Se a cadeia de entrada indicar uma hora UTC, através de um especificador de fuso horário ou AssumeUniversal, não ocorre conversão. Se a cadeia de entrada não indicar uma hora local ou UTC, não ocorre conversão e a propriedade resultante Kind é Unspecified. Este valor não pode ser usado com RoundtripKind. |
| AssumeLocal | 32 | Se não for especificado nenhum fuso horário na cadeia analisada, assume-se que a cadeia denota uma hora local. Este valor não pode ser usado com AssumeUniversal ou RoundtripKind. |
| AssumeUniversal | 64 | Se não for especificado nenhum fuso horário na cadeia analisada, assume-se que a cadeia denota um UTC. Este valor não pode ser usado com AssumeLocal ou RoundtripKind. |
| RoundtripKind | 128 | O DateTimeKind campo de uma data é preservado quando um DateTime objeto é convertido numa string usando o especificador de formato padrão "o" ou "r", e a string é então convertida de volta num DateTime objeto. |
Observações
DateTimeStyles Os valores podem ser usados com qualquer um dos seguintes métodos de análise sintática de data e hora que incluam um styles parâmetro para definir a interpretação dos elementos de estilo que podem estar presentes na cadeia a analisar:
Os ParseExact métodos e TryParseExact podem usar qualquer um dos DateTimeStyles valores. No entanto, se nenhum dos Allow* valores for selecionado, a cadeia de entrada deve ter exatamente os mesmos caracteres de espaço em branco que a cadeia de formato.
Se a cadeia de entrada não contiver qualquer indicação do fuso horário, os métodos de análise de data e hora interpretam o valor da cadeia de data e hora com base na definição do fuso horário do sistema operativo. Para converter a data e hora para a Hora Universal ou Hora Média de Greenwich (GMT), a aplicação deve usar o AdjustToUniversal valor. O mesmo efeito pode ser alcançado chamando o DateTime.ToUniversalTime método ou DateTimeOffset.ToUniversalTime . No entanto, usar o AdjustToUniversal valor com o método de análise de data e hora é mais eficiente.