DateTimeStyles Enum

Definition

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

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

public enum class DateTimeStyles
[System.Flags]
public enum DateTimeStyles
[System.Flags]
[System.Serializable]
public enum DateTimeStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum DateTimeStyles
type DateTimeStyles = 
Public Enum DateTimeStyles
Inheritance
DateTimeStyles
Attributes

Fields

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

Remarks

DateTimeStyles valores podem ser usados com qualquer um dos seguintes métodos de análise de data e hora que incluem um parâmetro styles para definir a interpretação dos elementos de estilo que podem estar presentes na cadeia de caracteres a ser analisada: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:

Os métodos ParseExact e TryParseExact podem usar qualquer um dos valores de DateTimeStyles.The ParseExact and TryParseExact methods can use any of the DateTimeStyles values. No entanto, se nenhum dos valores de Allow* 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.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, os métodos de análise de data e hora interpretam o valor da cadeia de caracteres de data e hora com base na configuração de fuso horário do 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 a hora em hora universal ou Greenwich Mean Time (GMT), o aplicativo deve usar o valor AdjustToUniversal.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 método DateTime.ToUniversalTime ou DateTimeOffset.ToUniversalTime.The same effect can be achieved by calling the DateTime.ToUniversalTime or DateTimeOffset.ToUniversalTime method. No entanto, o uso do valor AdjustToUniversal com o método de análise de data e hora é mais eficiente.However, using the AdjustToUniversal value with the date and time parsing method is more efficient.

Applies to

See also