DateTimeStyles Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define as opções de formatação que personalizam a análise de cadeia de caracteres para alguns métodos de análise de data e hora.
Essa enumeração dá suporte a uma combinação bit a bit dos valores de 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
| Nome | Valor | Description |
|---|---|---|
| None | 0 | As opções de formatação padrão devem ser usadas. Esse valor representa o estilo padrão para os Parse(String)métodos e TryParse(String, DateTime) . ParseExact(String, String, IFormatProvider) |
| AllowLeadingWhite | 1 | Os caracteres de espaço em branco à esquerda devem ser ignorados durante a análise, exceto se ocorrerem nos DateTimeFormatInfo padrões de formato. |
| AllowTrailingWhite | 2 | Caracteres de espaço em branco à direita devem ser ignorados durante a análise, exceto se ocorrerem nos DateTimeFormatInfo padrões de formato. |
| AllowInnerWhite | 4 | Caracteres de espaço em branco extras no meio da cadeia de caracteres devem ser ignorados durante a análise, exceto se ocorrerem nos DateTimeFormatInfo padrões de formato. |
| AllowWhiteSpaces | 7 | Caracteres de espaço em branco extras em qualquer lugar da cadeia de caracteres devem ser ignorados durante a análise, exceto se ocorrerem nos DateTimeFormatInfo padrões de formato. Esse valor é uma combinação de AllowLeadingWhitevalores e AllowInnerWhite valoresAllowTrailingWhite. |
| NoCurrentDateDefault | 8 | Se a cadeia de caracteres analisada contiver apenas a hora e não a data, os métodos de análise assumirão a data gregoriana com ano = 1, mês = 1 e dia = 1. Se esse valor não for usado, a data atual será assumida. |
| AdjustToUniversal | 16 | A data e a hora são retornadas como UTC (Tempo Universal Coordenado). Se a cadeia de caracteres de entrada indicar uma hora local, por meio de um especificador de fuso horário ou AssumeLocal, a data e a hora serão convertidas da hora local para UTC. Se a cadeia de caracteres de entrada indicar uma hora UTC, por meio de um especificador de fuso horário ou AssumeUniversal, nenhuma conversão ocorrerá. Se a cadeia de caracteres de entrada não denotar uma hora local ou UTC, nenhuma conversão ocorrerá e a propriedade resultante Kind será Unspecified. Esse valor não pode ser usado com RoundtripKind. |
| AssumeLocal | 32 | Se nenhum fuso horário for especificado na cadeia de caracteres analisada, a cadeia de caracteres será assumida para indicar uma hora local. Esse valor não pode ser usado com AssumeUniversal ou RoundtripKind. |
| AssumeUniversal | 64 | Se nenhum fuso horário for especificado na cadeia de caracteres analisada, a cadeia de caracteres será assumida para indicar um UTC. Esse valor não pode ser usado com AssumeLocal ou RoundtripKind. |
| RoundtripKind | 128 | O DateTimeKind campo de uma data é preservado quando um DateTime objeto é convertido em uma cadeia de caracteres usando o especificador de formato padrão "o" ou "r" e, em seguida, a cadeia de caracteres é convertida novamente em um DateTime objeto. |
Comentários
DateTimeStyles os valores podem ser usados com qualquer um dos seguintes métodos de análise de data e hora que incluem um styles parâmetro para definir a interpretação dos elementos de estilo que podem estar presentes na cadeia de caracteres a serem analisados:
O ParseExact método e o método TryParseExact podem usar qualquer um dos DateTimeStyles valores. No entanto, se nenhum dos Allow* valores estiver selecionado, a cadeia de caracteres de entrada deverá ter exatamente os mesmos caracteres de espaço em branco que a cadeia de caracteres de formato.
Se a cadeia de caracteres de entrada não contiver nenhuma indicação do fuso horário, os métodos de análise de data e hora interpretarão o valor da cadeia de caracteres de data e hora com base na configuração de fuso horário do sistema operacional. Para converter a data e a hora no Horário Universal ou horário de Greenwich (GMT), o aplicativo deve usar o AdjustToUniversal valor. O mesmo efeito pode ser obtido chamando o método ou DateTimeOffset.ToUniversalTime o DateTime.ToUniversalTime método. No entanto, usar o AdjustToUniversal valor com o método de análise de data e hora é mais eficiente.