標準 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 格式說明符產生的結果。