标准 DateTime 格式字符串
标准 DateTime 格式字符串包含一个标准 DateTime 格式说明符字符,该字符表示自定义 DateTime 格式字符串。格式字符串最终定义由格式化操作产生的 DateTime 对象的文本表示形式。请注意,任何包含一个以上字母字符(包括空白)的 DateTime 格式字符串都被解释为自定义 DateTime 格式字符串。
标准 DateTime 格式说明符
下表描述了标准 DateTime 格式说明符。有关各格式说明符所产生输出的示例,请参见标准 DateTime 格式字符串输出示例。
格式说明符 | 名称 | 说明 |
---|---|---|
d |
短日期模式 |
表示由当前 ShortDatePattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“MM/dd/yyyy”。 |
D |
长日期模式 |
表示由当前 LongDatePattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“dddd, dd MMMM yyyy”。 |
f |
完整日期/时间模式(短时间) |
表示长日期 (D) 和短时间 (t) 模式的组合,由空格分隔。 |
F |
完整日期/时间模式(长时间) |
表示由当前 FullDateTimePattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“dddd, dd MMMM yyyy HH:mm:ss”。 |
g |
常规日期/时间模式(短时间) |
表示短日期 (d) 和短时间 (t) 模式的组合,由空格分隔。 |
G |
常规日期/时间模式(长时间) |
表示短日期 (d) 和长时间 (T) 模式的组合,由空格分隔。 |
M 或 m |
月日模式 |
表示由当前 MonthDayPattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“MMMM dd”。 |
o |
往返日期/时间模式 |
表示使用保留时区信息的模式的自定义 DateTime 格式字符串。该模式专用于往返 DateTime 格式(包括文本形式的 Kind 属性)。随后将 Parse 或ParseExact 与正确的 Kind 属性值一起使用可以对格式化的字符串进行反向分析。 自定义格式字符串为“yyyy‘-‘MM‘-‘dd‘T‘HH‘:‘mm‘:‘ss.fffffffK”。 用于此说明符的模式是定义的标准。因此,无论所使用的区域性或所提供的格式提供程序是什么,它总是相同的。 |
R 或 r |
RFC1123 模式 |
表示由当前 RFC1123Pattern 属性定义的自定义 DateTime 格式字符串。该模式是定义的标准,并且属性是只读的。因此,无论所使用的区域性或所提供的格式提供程序是什么,它总是相同的。 定义格式字符串为“ddd, dd MMM yyyy HH‘:‘mm‘:‘ss ‘GMT‘”。 格式化不会修改正在格式化的 DateTime 对象的值。因此,应用程序在使用此格式说明符之前必须将该值转换为协调世界时 (UTC)。 |
s |
可排序的日期/时间模式;符合 ISO 8601 |
表示由当前 SortableDateTimePattern 属性定义的自定义 DateTime 格式字符串。此模式是定义的标准,并且属性是只读的。因此,无论所使用的区域性或所提供的格式提供程序是什么,它总是相同的。 自定义格式字符串为“yyyy‘-‘MM‘-‘dd‘T‘HH‘:‘mm‘:‘ss”。 |
t |
短时间模式 |
表示由当前 ShortTimePattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“HH:mm”。 |
T |
长时间模式 |
表示由当前 LongTimePattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“HH:mm:ss”。 |
u |
通用的可排序日期/时间模式 |
表示由当前 UniversalSortableDateTimePattern 属性定义的自定义 DateTime 格式字符串。此模式是定义的标准,并且属性是只读的。因此,无论所使用的区域性或所提供的格式提供程序是什么,它总是相同的。 自定义格式字符串为“yyyy‘-‘MM‘-‘dd HH‘:‘mm‘:‘ss‘Z‘”。 格式化日期和时间时不进行时区转换。因此,应用程序在使用此格式说明符之前必须将本地日期和时间转换为协调世界时 (UTC)。 |
U |
通用的可排序日期/时间模式 |
表示由当前 FullDateTimePattern 属性定义的自定义 DateTime 格式字符串。 此模式与完整日期/长时间 (F) 模式相同。但是,格式化将作用于等效于正在格式化的 DateTime 对象的协调世界时 (UTC)。 |
Y 或 y |
年月模式 |
表示由当前 YearMonthPattern 属性定义的自定义 DateTime 格式字符串。 例如,用于固定区域性的自定义格式字符串为“yyyy MMMM”。 |
任何其他单个字符 |
(未知说明符) |
未知说明符将引发运行时格式异常。 |
控制面板设置
控制面板中“区域和语言选项”项中的设置会影响由格式化操作产生的结果字符串。这些设置用于初始化与当前线程区域性关联的 DateTimeFormatInfo 对象,当前线程区域性将提供用于控制格式设置的值。使用不同设置的计算机会生成不同的结果字符串。
DateTimeFormatInfo 属性
格式化受当前 DateTimeFormatInfo 对象的属性影响,其由当前线程区域性隐式提供或由调用格式化的方法的 IFormatProvider 参数显示提供。为 IFormatProvider 参数指定一个表示区域性的CultureInfo 对象或指定一个 DateTimeFormatInfo 对象。
许多标准 DateTime 格式说明符是由当前 DateTimeFormatInfo 对象的属性定义的格式化模式的别名。因此,应用程序通过更改相应的 DateTimeFormatInfo 属性可以改变由某些标准DateTime 格式说明符产生的结果。