DateTimeStyles Enum

Definition

Определяет параметры форматирования, регулирующие синтаксический анализ строк для некоторых методов синтаксического анализа дат и времени.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

Дата и время возвращаются в формате UTC.Date and time are returned as a Coordinated Universal Time (UTC). Если во входной строке указано местное время (с помощью описателя часового пояса или AssumeLocal), дата и время преобразуются из местного времени в 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. Если во входной строке указано время в формате UTC (с помощью описателя часового пояса или AssumeUniversal), преобразование не выполняется.If the input string denotes a UTC time, through a time zone specifier or AssumeUniversal, no conversion occurs. Если во входной строке не указано местное время или время в формате UTC, преобразование не выполняется и результирующее свойство Kind имеет значение Unspecified.If the input string does not denote a local or UTC time, no conversion occurs and the resulting Kind property is Unspecified. Это значение невозможно использовать с RoundtripKind.This value cannot be used with RoundtripKind.

AllowInnerWhite 4

При анализе не следует учитывать дополнительные пробелы в середине строки. Исключением является их появление в шаблонах формата 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

При анализе не следует учитывать начальные пробелы. Исключением является их появление в шаблонах формата DateTimeFormatInfo.Leading white-space characters must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.

AllowTrailingWhite 2

При анализе не следует учитывать конечные пробелы. Исключением является их появление в шаблонах формата DateTimeFormatInfo.Trailing white-space characters must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.

AllowWhiteSpaces 7

При анализе не следует учитывать дополнительные пробелы в любом месте строки. Исключением является их появление в шаблонах формата DateTimeFormatInfo.Extra white-space characters anywhere in the string must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns. Это значение представляет собой сочетание значений AllowLeadingWhite, AllowTrailingWhite и AllowInnerWhite.This value is a combination of the AllowLeadingWhite, AllowTrailingWhite, and AllowInnerWhite values.

AssumeLocal 32

Если в анализируемой строке часовой пояс не указан, подразумевается, что используется местное время.If no time zone is specified in the parsed string, the string is assumed to denote a local time. Это значение невозможно использовать с AssumeUniversal или RoundtripKind.This value cannot be used with AssumeUniversal or RoundtripKind.

AssumeUniversal 64

Если в анализируемой строке часовой пояс не указан, подразумевается, что используется время в формате UTC.If no time zone is specified in the parsed string, the string is assumed to denote a UTC. Это значение невозможно использовать с AssumeLocal или RoundtripKind.This value cannot be used with AssumeLocal or RoundtripKind.

NoCurrentDateDefault 8

Если в анализируемой строке содержится только время и отсутствует дата, в методах анализа подразумевается дата по Григорианскому календарю, где год = 1, месяц = 1 и день = 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. Если это значение не используется, подразумевается текущая дата.If this value is not used, the current date is assumed.

None 0

Необходимо использовать параметры форматирования по умолчанию.Default formatting options must be used. Это значение представляет стиль по умолчанию для методов Parse(String), ParseExact(String, String, IFormatProvider) и TryParse(String, DateTime).This value represents the default style for the Parse(String), ParseExact(String, String, IFormatProvider), and TryParse(String, DateTime) methods.

RoundtripKind 128

Поле даты DateTimeKind сохраняется, когда объект DateTime преобразуется в строку с помощью описателя стандартного формата "o" или "r", а затем строка преобразуется обратно в объект 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 значения можно использовать с любым из следующих методов синтаксического анализа даты и времени, включающих параметр styles, чтобы определить интерпретацию элементов стиля, которые могут присутствовать в анализируемой строке: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:

Методы ParseExact и TryParseExact могут использовать любые DateTimeStyles значения.The ParseExact and TryParseExact methods can use any of the DateTimeStyles values. Однако если ни одно из Allow* значений не выбрано, входная строка должна содержать точно такие же символы пробела, что и строка формата.However, if none of the Allow* values is selected, the input string must have exactly the same white-space characters as the format string.

Если входная строка не содержит указания часового пояса, методы синтаксического анализа даты и времени преобразуют значение строки даты и времени на основе параметра часового пояса для операционной системы.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. Чтобы преобразовать дату и время в универсальное время или время по Гринвичу (GMT), приложение должно использовать значение AdjustToUniversal.To convert the date and time to the Universal Time or Greenwich Mean Time (GMT), the application should use the AdjustToUniversal value. Тот же результат можно получить, вызвав метод DateTime.ToUniversalTime или DateTimeOffset.ToUniversalTime.The same effect can be achieved by calling the DateTime.ToUniversalTime or DateTimeOffset.ToUniversalTime method. Однако использование значения AdjustToUniversal с методом анализа даты и времени является более эффективным.However, using the AdjustToUniversal value with the date and time parsing method is more efficient.

Applies to

See also