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 para de cadeia de caracteres de alguns métodos 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
| AdjustToUniversal | 16 | Data e hora são retornados como UTC (Tempo Universal Coordenado). Se a cadeia de caracteres de entrada denotar uma hora local, por meio de um especificador de fuso horário ou AssumeLocal, a data e hora serão convertidas da hora local para UTC. Se a cadeia de caracteres de entrada denotar uma hora em UTC, por meio de um especificador de fuso horário ou AssumeUniversal, não ocorrerá nenhuma conversão. Se a cadeia de caracteres de entrada não denotar uma hora local ou em UTC, nenhuma conversão ocorrerá e a propriedade Kind resultante será Unspecified. Este valor pode não ser usado com RoundtripKind. |
| AllowInnerWhite | 4 | Caracteres de espaço em branco extra no meio da cadeia de caracteres deverão ser ignorados durante a análise, exceto se ocorrerem nos padrões de formatação DateTimeFormatInfo. |
| AllowLeadingWhite | 1 | Os caracteres de espaço em branco à esquerda deverão ser ignorados durante a análise, exceto se ocorrerem nos padrões de formatação DateTimeFormatInfo. |
| AllowTrailingWhite | 2 | Os caracteres de espaço em branco à direita deverão ser ignorados durante a análise, exceto se ocorrerem nos padrões de formatação DateTimeFormatInfo. |
| AllowWhiteSpaces | 7 | Caracteres de espaço em branco extra em qualquer parte da cadeia de caracteres deverão ser ignorados durante a análise, exceto se ocorrerem nos padrões de formatação DateTimeFormatInfo. Esse valor é uma combinação dos valores AllowLeadingWhite, AllowTrailingWhite e AllowInnerWhite. |
| AssumeLocal | 32 | Se não for especificado nenhum fuso horário na cadeia de caracteres analisada, será considerado que a cadeia de caracteres denota uma hora local. Este valor pode não ser usado com AssumeUniversal nem com RoundtripKind. |
| AssumeUniversal | 64 | Se não for especificado nenhum fuso horário na cadeia de caracteres analisada, será considerado que a cadeia de caracteres denota uma hora em UTC. Este valor pode não ser usado com AssumeLocal nem com RoundtripKind. |
| NoCurrentDateDefault | 8 | Se a cadeia de caracteres analisada contiver apenas a hora e não a data, os métodos de análise utilizarão a data no calendário gregoriano, com ano = 1, mês = 1 e dia = 1. Se esse valor não for usado, a data atual será presumida. |
| None | 0 | Opções de formatação padrão devem ser usadas. Esse valor representa o estilo padrão dos métodos Parse(String), ParseExact(String, String, IFormatProvider) e TryParse(String, DateTime). |
| RoundtripKind | 128 | O campo DateTimeKind de uma data é preservado quando um objeto DateTime é convertido em uma cadeia de caracteres usando o especificador de formato padrão "o" ou "r", e a cadeia de caracteres é convertida de volta em um objeto DateTime. |
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 ser analisada:
Os ParseExact métodos e os TryParseExact métodos podem usar qualquer um dos DateTimeStyles valores. No entanto, se nenhum dos Allow* valores for 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 qualquer 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 para a Hora Universal ou Hora Média 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.