DateTimeStyles DateTimeStyles DateTimeStyles DateTimeStyles Enum

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.Defines the formatting options that customize string parsing for some date and time parsing methods.

Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos seus valores membros.

public enum class DateTimeStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum DateTimeStyles
type DateTimeStyles = 
Public Enum DateTimeStyles
Herança
DateTimeStylesDateTimeStylesDateTimeStylesDateTimeStyles
Atributos

Campos

AdjustToUniversal AdjustToUniversal AdjustToUniversal AdjustToUniversal 16

Data e hora são retornados como UTC (Tempo Universal Coordenado).Date and time are returned as a Coordinated Universal Time (UTC). 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.If the input string denotes a local time, through a time zone specifier or AssumeLocal, the date and time are converted from the local time to 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.If the input string denotes a UTC time, through a time zone specifier or AssumeUniversal, no conversion occurs. 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.If the input string does not denote a local or UTC time, no conversion occurs and the resulting Kind property is Unspecified. Este valor pode não ser usado com RoundtripKind.This value cannot be used with RoundtripKind.

AllowInnerWhite AllowInnerWhite AllowInnerWhite 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.Extra white-space characters in the middle of the string must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.

AllowLeadingWhite AllowLeadingWhite AllowLeadingWhite 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.Leading white-space characters must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.

AllowTrailingWhite AllowTrailingWhite AllowTrailingWhite 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.Trailing white-space characters must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.

AllowWhiteSpaces AllowWhiteSpaces AllowWhiteSpaces 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.Extra white-space characters anywhere in the string must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns. Esse valor é uma combinação dos valores AllowLeadingWhite, AllowTrailingWhite e AllowInnerWhite.This value is a combination of the AllowLeadingWhite, AllowTrailingWhite, and AllowInnerWhite values.

AssumeLocal AssumeLocal AssumeLocal 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.If no time zone is specified in the parsed string, the string is assumed to denote a local time. Este valor pode não ser usado com AssumeUniversal nem com RoundtripKind.This value cannot be used with AssumeUniversal or RoundtripKind.

AssumeUniversal AssumeUniversal AssumeUniversal 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.If no time zone is specified in the parsed string, the string is assumed to denote a UTC. Este valor pode não ser usado com AssumeLocal nem com RoundtripKind.This value cannot be used with AssumeLocal or RoundtripKind.

NoCurrentDateDefault NoCurrentDateDefault NoCurrentDateDefault 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.If the parsed string contains only the time and not the date, the parsing methods assume the Gregorian date with year = 1, month = 1, and day = 1. Se esse valor não for usado, a data atual será presumida.If this value is not used, the current date is assumed.

None None None None 0

Opções de formatação padrão devem ser usadas.Default formatting options must be used. Esse valor representa o estilo padrão dos métodos Parse(String), ParseExact(String, String, IFormatProvider) e TryParse(String, DateTime).This value represents the default style for the Parse(String), ParseExact(String, String, IFormatProvider), and TryParse(String, DateTime) methods.

RoundtripKind RoundtripKind RoundtripKind 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.The DateTimeKind field of a date is preserved when a DateTime object is converted to a string using the "o" or "r" standard format specifier, and the string is then converted back to a DateTime object.

Comentários

DateTimeStyles valores podem ser usados com qualquer um dos seguintes data e hora de métodos de análise 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 analisado:DateTimeStyles values can be used with any of the following date and time parsing methods that include a styles parameter to define the interpretation of the style elements that may be present in the string to be parsed:

O ParseExact e TryParseExact métodos podem usar qualquer um do DateTimeStyles valores.The ParseExact and TryParseExact methods can use any of the DateTimeStyles values. No entanto, se nenhum do Allow* valores for selecionada, a cadeia de caracteres de entrada deve ter exatamente os mesmos caracteres de espaço em branco como a cadeia de caracteres de formato.However, if none of the Allow* values is selected, the input string must have exactly the same white-space characters as the format string.

Se a cadeia de caracteres de entrada não contiver nenhuma indicação do fuso horário, a data e hora de métodos de análise interpretam o valor da cadeia de caracteres de data e hora com base na configuração de fuso horário para o sistema operacional.If the input string does not contain any indication of the time zone, the date and time parsing methods interpret the value of the date and time string based on the time zone setting for the operating system. Para converter a data e hora para o tempo Universal ou a hora de Greenwich (GMT), o aplicativo deve usar o AdjustToUniversal valor.To convert the date and time to the Universal Time or Greenwich Mean Time (GMT), the application should use the AdjustToUniversal value. O mesmo efeito pode ser obtido chamando o DateTime.ToUniversalTime ou DateTimeOffset.ToUniversalTime método.The same effect can be achieved by calling the DateTime.ToUniversalTime or DateTimeOffset.ToUniversalTime method. No entanto, usando o AdjustToUniversal valor com a data e hora ao método de análise é mais eficiente.However, using the AdjustToUniversal value with the date and time parsing method is more efficient.

Aplica-se a

Veja também