自定义日期和时间格式字符串

Black2024年12月22日大约 9 分钟

自定义日期和时间格式字符串

部分格式会受到语种和国家地区影响。

假定x为DateTimeZone.From("2022-09-05T18:03:56.123450-08:00")。

下表示例使用(格式, 区域)=DateTimeZone.ToText(x, 格式, 区域)。

%

需组合列含义：

是：单独使用时需在前面添加%
可能：视情况考虑是否添加%，通常都是一个或若干个重复字符才会如此。如%f和ff。
空白：可单独使用且不需要添加%。

格式说明符	需组合	说明	示例
`d`	是	日	`("%d", "en-US") = 5`
`dd`		两位日	`("dd", "en-US") = 05`
`ddd`		星期几简称	`("ddd", "zh-CN") = 周一` `("ddd", "en-US") = Mon`
`dddd`		星期几全称	`("dddd", "zh-CN") = 星期一` `("dddd", "en-US") = Monday`
`f`	可能	更小的秒，个数表示位数精确保证位数，可能补0 可以最多7个`f`组合 `f`不可与`F`混用	`("%f", "en-US") = 1` `("s.ff", "en-US") = 56.12` `("s.ffffff", "en-US") = 56.123450` `("FFFfff", "en-US") = 123123`
`F`	可能	更小的秒，个数表示位数最大位数为源数据位数可以最多7个`F`组合 `f`不可与`F`混用	`("%F", "en-US") = 1` `("FF", "en-US") = 12` `("s.FFFFFF", "en-US") = 56.12345` `("FFFfff", "en-US") = 123123`
`g`、`gg`	可能	时期或时代	`("%g", "zh-CN") = 公元` `("gyyyy", "zh-CN") = 公元2022` `("gyyyy", "en-US") = A.D.2022`
`h`	是	时 12小时制（1-12）	`("%h", "zh-CN") = 6` `("h:m", "en-US") = 6:3`
`hh`		两位时 12小时制（1-12）	`("hh", "zh-CN") = 06` `("hh", "en-US") = 06`
`H`	是	时 24小时制（0-23）	`("%H", "zh-CN") = 18` `("H:m", "en-US") = 18:3`
`HH`		两位时 24小时制（0-23）	`("HH", "zh-CN") = 18` `("HH", "en-US") = 18`
`K`	是	时区信息	`("%K", "zh-CN") = -08:00`
`m`	是	分钟	`("%m", "zh-CN") = 3`
`mm`		两位分钟	`("mm", "zh-CN") = 03` `("h:mm", "zh-CN") = 6:03`
`M`	是	月	`("%M", "zh-CN") = 9` `("M-d", "en-US") = 9-5`
`MM`		两位月	`("MM", "en-US") = 09`
`MMM`		月份简称	`("MMM", "zh-CN") = 9月` `("MMM", "en-US") = Sep`
`MMMM`		月份全称	`("MMMM", "zh-CN") = 九月` `("MMMM", "en-US") = September`
`s`	是	秒	`("%s", "zh-CN") = 56`
`ss`		两位秒	`("ss", "zh-CN") = 56`
`t`	是	上午/下午的第一个字符会因为语言不同而不同	`("HH t", "zh-CN") = 18 下` `("HH t", "en-US") = 18 P` `("HH t", "ja-JP") = 18 午`
`tt`		上午/下午会因为语言不同而不同	`("HH tt", "zh-CN") = 18 下午` `("HH tt", "en-US") = 18 PM` `("HH tt", "ja-JP") = 18 午後`
`y`	是	年份（0-99）	`("%y", "zh-CN") = 22`
`yy`		年份（00-99）	`("yy", "zh-CN") = 22`
`yyy`		年份（000-9999）最低3位	`("yyy", "zh-CN") = 2022`
`yyyy`		年份（0000-9999）	`("yyyy", "zh-CN") = 2022`
`yyyy`		年份（00000-99999）	`("yyyy", "zh-CN") = 02022`
`z`	是	时区仅小时，不含分钟	`("%z", "zh-CN") = -8`
`zz`		时区两位小时，不含分钟	`("zz", "zh-CN") = -08`
`zzz`		时区含时分	`("zzz", "zh-CN") = -08:00`
`:`	是	时间分隔符不一定非要分隔时分秒	`("mm:ss") = 03:56` `("yyyy:MM") = 2022:09`
`/`	是	日期分隔符不一定非要分隔年月日	`("mm/ss") = 03/56` `("yyyy/MM") = 2022/09`
`""`、`''`		字面文本分隔符保持引号之间的内容不变	`("yyyy'K'") = 2022K` `("yyyy""K""") = 2022K`
`%`		指示之后的字符是自定义格式说明符 `%`之后的一个字符和其他字符会分开解析	`("%d") = 5` `("d") = 2022/9/5` `("%MM") = 99`
`\`		转义符	`("yyyy\K") = 2022K` `("yyyy\MM") = 2022M9` `("yyyy\M\M") = 2022MM`
其它		其他字符保持原样	`("今天是MM/dd") = 今天是09/05` `("today is MM/dd") = 下o5a22 i56 09/05`