DateTimeStyles Перечисление

Определение

Определяет параметры форматирования, задающие пользовательские настройки синтаксического анализа строки для ряда методов синтаксического анализа даты и времени.Defines the formatting options that customize string parsing for some date and time parsing methods.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class DateTimeStyles
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum DateTimeStyles
type DateTimeStyles = 
Public Enum DateTimeStyles
Наследование
DateTimeStyles
Атрибуты

Поля

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

Комментарии

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

Применяется к

Дополнительно