Compartilhar via


DateTimeStyles Enumeração

Definição

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
DateTimeStyles
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 TryParseExact 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 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 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 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.

Aplica-se a

Confira também