语言

DateTimeStyles 枚举

定义

定义自定义某些日期和时间分析方法的字符串分析的格式设置选项。

此枚举支持其成员值的按位组合。

public enum class DateTimeStyles
[System.Flags]
public enum DateTimeStyles
[System.Flags]
[System.Serializable]
public enum DateTimeStyles
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum DateTimeStyles
[<System.Flags>]
type DateTimeStyles = 
[<System.Flags>]
[<System.Serializable>]
type DateTimeStyles = 
[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeStyles = 
Public Enum DateTimeStyles
继承
DateTimeStyles
属性

字段

名称 值 说明
None 0

必须使用默认格式设置选项。 此值表示和方法的默认样式Parse(String)ParseExact(String, String, IFormatProvider)TryParse(String, DateTime)。

AllowLeadingWhite 1

在分析过程中必须忽略前导空格字符,除非它们以 DateTimeFormatInfo 格式模式出现。

AllowTrailingWhite 2

在分析期间必须忽略尾随空格字符,除非它们以 DateTimeFormatInfo 格式模式出现。

AllowInnerWhite 4

在分析过程中必须忽略字符串中间的额外空格字符,除非它们以 DateTimeFormatInfo 格式模式出现。

AllowWhiteSpaces 7

在分析过程中必须忽略字符串中的任何位置的额外空格字符,除非它们以 DateTimeFormatInfo 格式模式出现。 此值是和AllowLeadingWhiteAllowTrailingWhite值的组合AllowInnerWhite。

NoCurrentDateDefault 8

如果分析的字符串仅包含时间和日期,则分析方法假定公历日期的年份 = 1,月 = 1,日 = 1。 如果未使用此值,则假定当前日期。

AdjustToUniversal 16

日期和时间以协调世界时(UTC)的形式返回。 如果输入字符串表示本地时间,则通过时区说明符或 AssumeLocal日期和时间从本地时间转换为 UTC。 如果输入字符串表示 UTC 时间,则通过时区说明符或 AssumeUniversal不会发生转换。 如果输入字符串不表示本地时间或 UTC 时间,则不会发生转换,生成的 Kind 属性为 Unspecified。 此值不能与 RoundtripKind.

AssumeLocal 32

如果未在分析的字符串中指定时区,则假定该字符串表示本地时间。 此值不能用于 AssumeUniversal 或 RoundtripKind.

AssumeUniversal 64

如果未在分析的字符串中指定时区,则假定该字符串表示 UTC。 此值不能用于 AssumeLocal 或 RoundtripKind.

RoundtripKind 128

DateTimeKind使用“o”或“r”标准格式说明符将对象转换为字符串时DateTime,将保留日期的字段,然后将该字符串转换回对象DateTime。

注解

DateTimeStyles 值可以与以下任一日期和时间分析方法一起使用,这些方法包括一个 styles 参数,用于定义字符串中可能存在的样式元素的解释以进行分析:

和ParseExactTryParseExact方法可以使用任何DateTimeStyles值。 但是,如果未选择任何 Allow* 值,则输入字符串必须与格式字符串完全相同的空格字符。

如果输入字符串不包含时区的任何指示,则日期和时间分析方法会根据操作系统的时区设置解释日期和时间字符串的值。 若要将日期和时间转换为环球时或格林威治平均时间(GMT),应用程序应使用 AdjustToUniversal 该值。 通过调用 DateTime.ToUniversalTime 或 DateTimeOffset.ToUniversalTime 方法可以实现相同的效果。 但是,将 AdjustToUniversal 该值与日期和时间分析方法结合使用会更高效。

适用于

另请参阅