DateTimeStyles Enumeration

Defines the formatting options that customize string parsing for the DateTime.Parse and DateTime.TryParse methods.

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

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
[FlagsAttribute]
public enum DateTimeStyles

Member nameDescription
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkNoneDefault formatting options must be used. This value represents the default style for DateTime.Parse, DateTime.ParseExact, and DateTime.TryParse.
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAllowLeadingWhiteLeading white-space characters must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAllowTrailingWhiteTrailing white-space characters must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAllowInnerWhiteExtra white-space characters in the middle of the string must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns.
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAllowWhiteSpacesExtra white-space characters anywhere in the string must be ignored during parsing, except if they occur in the DateTimeFormatInfo format patterns. This value is a combination of the AllowLeadingWhite, AllowTrailingWhite, and AllowInnerWhite values.
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkNoCurrentDateDefaultIf 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.
Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAdjustToUniversalDate and time are returned as a Coordinated Universal Time (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. If the input string denotes a UTC time, through a time zone specifier or AssumeUniversal, no conversion occurs. If the input string does not denote a local or UTC time, no conversion occurs and the resulting Kind property is Unspecified.

Cannot be used with RoundtripKind.

Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAssumeLocalIf no time zone is specified in the parsed string, the string is assumed to denote a local time.

Cannot be used with AssumeUniversal or RoundtripKind.

Supported by the .NET Compact FrameworkSupported by the XNA FrameworkAssumeUniversalIf no time zone is specified in the parsed string, the string is assumed to denote a UTC.

Cannot be used with AssumeLocal or RoundtripKind.

Supported by the .NET Compact FrameworkSupported by the XNA FrameworkRoundtripKindThe 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.

The DateTime.TryParse method can use any of DateTimeStyles values. 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, DateTime.Parse and DateTime.TryParse read the date and time based on the time zone setting for the operating system. To convert the date and time to the Universal Time or Greenwich Mean Time (GMT), the application should use the AdjustToUniversal value. The same effect can be achieved using ToUniversalTime. However, using the AdjustToUniversal value with DateTime.Parse or DateTime.TryParse is more efficient.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft