关于C#中日期和时间字符串格式化的说明

一、标准日期和时间格式字符串:
标准日期和时间格式字符串使用单个格式说明符来定义日期和时间值的文本表示形式。包含一个以上字符(包括空白)的任何日期和时间格式字符串都会被解释为自定义日期和时间格式字符串。可通过两种方式使用标准或自定义格式字符串:定义由格式设置操作生成的字符串;定义可通过分析操作转换为DateTime或DateTimeOffset值的日期和时间值的文本表示形式。
标准日期和时间格式字符串可以与DateTime和DateTimeOffset值一起使用。
以下列出支持的标准日期和时间格式说明符并显示由每个格式说明符产生的示例输出:

“d”
说明:短日期模式。
示例:
2009-06-15T13:45:30 -> 6/15/2009 (en-US)
2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)
2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)

“D”
说明:长日期模式。
示例:
2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)
2009-06-15T13:45:30 -> Montag, 15.Juni 2009 (de-DE)

“f”
说明:完整日期/时间模式(短时间)。
示例:
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)
2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

“F”
说明:完整日期/时间模式(长时间)。
示例:
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (zh-CN)
2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

“g”
说明:常规日期/时间模式(短时间)。
示例:
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)
2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)
2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)

“G”
说明:常规日期/时间模式(长时间)。
示例:
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)
2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)
2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)

“M”、”m”
说明:月/日模式。
示例:
2009-06-15T13:45:30 -> June 15 (en-US)
2009-06-15T13:45:30 -> 15.juni (da-DK)
2009-06-15T13:45:30 -> 15 Juni (id-ID)

“O”、”o”
说明:往返日期/时间模式。
示例:
DateTime值:
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30.0000000-07:00
2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30.0000000Z
2009-06-15T13:45:30 (DateTimeKind.Unspecified) -> 2009-06-15T13:45:30.0000000
DateTimeOffset值:
2009-06-15T13:45:30-07:00 -> 2009-06-15T13:45:30.0000000-07:00

“R”、”r”
说明:RFC1123模式。
示例:
2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT

“s”
说明:可排序日期/时间模式。
示例:
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30
2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30

“t”
说明:短时间模式。
示例:
2009-06-15T13:45:30 -> 1:45 PM (en-US)
2009-06-15T13:45:30 -> 13:45 (hr-HR)

“T”
说明:长时间模式。
示例:
2009-06-15T13:45:30 -> 1:45:30 PM (en-US)
2009-06-15T13:45:30 -> 13:45:30 (hr-HR)

“u”
说明:通用可排序日期/时间模式。
示例:
2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z

“U”
说明:通用完整日期/时间模式。
示例:
2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)
2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE)

“Y”、”y”
说明:年月模式。
示例:
2009-06-15T13:45:30 -> June, 2009 (en-US)
2009-06-15T13:45:30 -> juni 2009 (da-DK)
2009-06-15T13:45:30 -> Juni 2009 (id-ID)

任何其他单个字符
说明:未知说明符,引发运行时FormatException。

二、自定义日期和时间格式字符串:
日期和时间格式字符串定义由格式设置操作生成的DateTime或DateTimeOffset值的文本表示形式。它还可定义分析操作中需要的日期和时间值的表示形式,以便成功将字符串转换为日期和时间。自定义格式字符串由一个或多个自定义日期和时间格式说明符组成。任何不是标准日期和时间格式字符串的字符串都会解释为自定义日期和时间格式字符串。
自定义日期和时间格式字符串可以与DateTime和DateTimeOffset值一起使用。
以下列出支持的自定义日期和时间格式说明符并显示由每个格式说明符产生的示例输出:

“d”
说明:一个月中的某一天(1到31)。
示例:
2009-06-01T13:45:30 -> 1
2009-06-15T13:45:30 -> 15

“dd”
说明:一个月中的某一天(01到31)。
示例:
2009-06-01T13:45:30 -> 01
2009-06-15T13:45:30 -> 15

“ddd”
说明:一周中某天的缩写名称。
示例:
2009-06-15T13:45:30 -> Mon (en-US)
2009-06-15T13:45:30 -> lun.(fr-FR)

“dddd”
说明:一周中某天的完整名称。
示例:
2009-06-15T13:45:30 -> Monday (en-US)
2009-06-15T13:45:30 -> lundi (fr-FR)

“f”
说明:日期和时间值的十分之几秒。
示例:
2009-06-15T13:45:30.6170000 -> 6
2009-06-15T13:45:30.05 -> 0

“ff”
说明:日期和时间值的百分之几秒。
示例:
2009-06-15T13:45:30.6170000 -> 61
2009-06-15T13:45:30.0500000 -> 00

“fff”
说明:日期和时间值的千分之几秒。
示例:
6/15/2009 13:45:30.617 -> 617
6/15/2009 13:45:30.0005 -> 000

“ffff”
说明:日期和时间值的万分之几秒。
示例:
2009-06-15T13:45:30.6175000 -> 6175
2009-06-15T13:45:30.0000500 -> 0000

“fffff”
说明:日期和时间值的十万分之几秒。
示例:
2009-06-15T13:45:30.6175400 -> 61754
6/15/2009 13:45:30.000005 -> 00000

“ffffff”
说明:日期和时间值的百万分之几秒。
示例:
2009-06-15T13:45:30.6175420 -> 617542
2009-06-15T13:45:30.0000005 -> 000000

“fffffff”
说明:日期和时间值的千万分之几秒。
示例:
2009-06-15T13:45:30.6175425 -> 6175425
2009-06-15T13:45:30.0001150 -> 0001150

“F”
说明:如果非零,则为日期和时间值的十分之几秒。
示例:
2009-06-15T13:45:30.6170000 -> 6
2009-06-15T13:45:30.0500000 ->(无输出)

“FF”
说明:如果非零,则为日期和时间值的百分之几秒。
示例:
2009-06-15T13:45:30.6170000 -> 61
2009-06-15T13:45:30.0050000 ->(无输出)

“FFF”
说明:如果非零,则为日期和时间值的千分之几秒。
示例:
2009-06-15T13:45:30.6170000 -> 617
2009-06-15T13:45:30.0005000 ->(无输出)

“FFFF”
说明:如果非零,则为日期和时间值的万分之几秒。
示例:
2009-06-15T13:45:30.5275000 -> 5275
2009-06-15T13:45:30.0000500 ->(无输出)

“FFFFF”
说明:如果非零,则为日期和时间值的十万分之几秒。
示例:
2009-06-15T13:45:30.6175400 -> 61754
2009-06-15T13:45:30.0000050 ->(无输出)

“FFFFFF”
说明:如果非零,则为日期和时间值的百万分之几秒。
示例:
2009-06-15T13:45:30.6175420 -> 617542
2009-06-15T13:45:30.0000005 ->(无输出)

“FFFFFFF”
说明:如果非零,则为日期和时间值的千万分之几秒。
示例:
2009-06-15T13:45:30.6175425 -> 6175425
2009-06-15T13:45:30.0001150 -> 000115

“g”、”gg”
说明:时期或纪元。
示例:
2009-06-15T13:45:30.6170000 -> A.D.

“h”
说明:采用12小时制的小时(从1到12)。
示例:
2009-06-15T01:45:30 -> 1
2009-06-15T13:45:30 -> 1

“hh”
说明:说明:采用12小时制的小时(从01到12)。
示例:
2009-06-15T01:45:30 -> 01
2009-06-15T13:45:30 -> 01

“H”
说明:采用24小时制的小时(从0到23)。
示例:
2009-06-15T01:45:30 -> 1
2009-06-15T13:45:30 -> 13

“HH”
说明:采用24小时制的小时(从00到23)。
示例:
2009-06-15T01:45:30 -> 01
2009-06-15T13:45:30 -> 13

“K”
说明:时区信息。
示例:
DateTime值:
2009-06-15T13:45:30, Kind Unspecified ->
2009-06-15T13:45:30, Kind Utc -> Z
2009-06-15T13:45:30, Kind Local -> -07:00(取决于本地计算机的设置)
DateTimeOffset值:
2009-06-15T01:45:30-07:00 -> -07:00
2009-06-15T08:45:30+00:00 -> +00:00

“m”
说明:分钟(0到59)。
示例:
2009-06-15T01:09:30 -> 9
2009-06-15T13:29:30 -> 29

“mm”
说明:分钟(00到59)。
示例:
2009-06-15T01:09:30 -> 09
2009-06-15T01:45:30 -> 45

“M”
说明:月份(1到12)。
示例:
2009-06-15T13:45:30 -> 6

“MM”
说明:月份(1到12)。
示例:
2009-06-15T13:45:30 -> 06

“MMM”
说明:月份的缩写名称。
示例:
2009-06-15T13:45:30 -> Jun (en-US)
2009-06-15T13:45:30 -> juin (fr-FR)
2009-06-15T13:45:30 -> Jun (zu-ZA)

“MMMM”
说明:月份的完整名称。
示例:
2009-06-15T13:45:30 -> June (en-US)
2009-06-15T13:45:30 -> juni (da-DK)
2009-06-15T13:45:30 -> uJuni (zu-ZA)

“s”
说明:秒(0到59)。
示例:
2009-06-15T13:45:09 -> 9

“ss”
说明:秒(00到59)。
示例:
2009-06-15T13:45:09 -> 09

“t”
说明:AM/PM指示符的第一个字符。
示例:
2009-06-15T13:45:30 -> P (en-US)
2009-06-15T13:45:30 -> (fr-FR)

“tt”
说明:AM/PM指示符。
示例:
2009-06-15T13:45:30 -> PM (en-US)
2009-06-15T13:45:30 -> (fr-FR)

“y”
说明:年份(0到99)。
示例:
0001-01-01T00:00:00 -> 1
0900-01-01T00:00:00 -> 0
1900-01-01T00:00:00 -> 0
2009-06-15T13:45:30 -> 9
2019-06-15T13:45:30 -> 19

“yy”
说明:年份(00到99)。
示例:
0001-01-01T00:00:00 -> 01
0900-01-01T00:00:00 -> 00
1900-01-01T00:00:00 -> 00
2019-06-15T13:45:30 -> 19

“yyy”
说明:年份(最少三位数字)。
示例:
0001-01-01T00:00:00 -> 001
0900-01-01T00:00:00 -> 900
1900-01-01T00:00:00 -> 1900
2009-06-15T13:45:30 -> 2009

“yyyy”
说明:由四位数字表示的年份。
示例:
0001-01-01T00:00:00 -> 0001
0900-01-01T00:00:00 -> 0900
1900-01-01T00:00:00 -> 1900
2009-06-15T13:45:30 -> 2009

“yyyyy”
说明:由五位数字表示的年份。
示例:
0001-01-01T00:00:00 -> 00001
2009-06-15T13:45:30 -> 02009

“z”
说明:相对于UTC的小时偏移量,无前导零。
示例:
2009-06-15T13:45:30-07:00 -> -7

“zz”
说明:相对于UTC的小时偏移量,带有表示一位数值的前导零。
示例:
2009-06-15T13:45:30-07:00 -> -07

“zzz”
说明:相对于UTC的小时和分钟偏移量。
示例:
2009-06-15T13:45:30-07:00 -> -07:00

“:”
说明:时间分隔符。
示例:
2009-06-15T13:45:30 -> : (en-US)
2009-06-15T13:45:30 -> .(it-IT)
2009-06-15T13:45:30 -> : (ja-JP)

“/”
说明:日期分隔符。
示例:
2009-06-15T13:45:30 -> / (en-US)
2009-06-15T13:45:30 -> – (ar-DZ)
2009-06-15T13:45:30 -> .(tr-TR)

‘字符’或”字符串”
说明:文本字符串分隔符。
2009-06-15T13:45:30 (“arr:” h:m t) -> arr: 1:45 P
2009-06-15T13:45:30 (‘arr:’ h:m t) -> arr: 1:45 P

“%”
说明:将下面的字符定义为自定义格式说明符。
示例:
2009-06-15T13:45:30 (%h) -> 1

“\”
说明:转义字符。
示例:
2009-06-15T13:45:30 (h \h) -> 1 h

任何其他字符
说明:字符将复制到未更改的结果字符串。
示例:
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

更多信息请参阅:标准日期和时间格式字符串自定义日期和时间格式字符串

发表评论