自定义日期时间格式字符串
2024年12月22日大约 3 分钟
自定义日期时间格式字符串
参考资料:自定义日期时间格式字符串。
部分格式会受到国家地区影响,默认使用本机设置。
假定x
表示日期时间2022-09-05T02:03:56.66666+08:30
。
下表示例使用DateTimeZone.ToText
。
注:有些符号属于标准日期时间格式字符串,单独使用需要在前面加%
,下表有提及。
格式说明符 | 需组合 | 说明 | 示例 |
---|---|---|---|
d | 是 | 日 | (x, "%d", "en-US") = 5 |
dd | 两位日 | (x, "dd", "en-US") = 05 | |
ddd | 星期几简称 | (x, "ddd", "zh-CN") = 周一 (x, "ddd", "en-US") = Mon | |
dddd | 星期几全称 | (x, "dddd", "zh-CN") = 星期一 (x, "dddd", "en-US") = Monday | |
f | 可能 | 更小的秒,个数表示位数 精确保证位数,可能补0 可以最多7个 f 组合f 需组合其它说明符 | (x, "%f", "en-US") = 6 (x, "s.ff", "en-US") = 56.66 (x, "s.ffffff", "en-US") = 56.666600 |
F | 可能 | 更小的秒,个数表示位数 最大位数为源数据位数 可以最多7个 F 组合F 需组合其它说明符 | (x, "%F", "en-US") = 6 (x, "FF", "en-US") = 66 (x, "FFFFFF", "en-US") = 56.6666 |
g 、gg | 可能 | 时期或时代g 需要组合其它说明符 | (x, "%g", "zh-CN") = 公元 (x, "gyyyy", "zh-CN") = 公元2022 (x, "gyyyy", "en-US") = A.D.2022 |
h | 是 | 时 12小时制(1-12) | (x, "%h", "zh-CN") = 2 (x, "h:m", "en-US") = 2:3 |
hh | 两位时 12小时制(1-12) | (x, "hh", "zh-CN") = 02 (x, "hh", "en-US") = 02 | |
H | 是 | 时 24小时制(0-23) | (x, "%H", "zh-CN") = 2 (x, "H:m", "en-US") = 2:3 |
HH | 两位时 24小时制(0-23) | (x, "HH", "zh-CN") = 02 (x, "HH", "en-US") = 02 | |
K | 是 | 时区信息 | (x, "%K", "zh-CN") = +08:30 |
m | 是 | 分钟 | (x, "%m", "zh-CN") = 3 |
mm | 两位分钟 | (x, "mm", "zh-CN") = 03 (x, "h:mm", "zh-CN") = 2:03 | |
M | 是 | 月 | (x, "%M", "zh-CN") = 9 (x, "M-d", "en-US") = 9-5 |
MM | 两位月 | (x, "MM", "en-US") = 09 | |
MMM | 月份简称 | (x, "MMM", "zh-CN") = 9月 (x, "MMM", "en-US") = Sep | |
MMMM | 月份全称 | (x, "MMMM", "zh-CN") = 九月 (x, "MMMM", "en-US") = September | |
s | 是 | 秒 | (x, "%s", "zh-CN") = 56 |
ss | 两位秒 | (x, "ss", "zh-CN") = 56 | |
t | 上午/下午的第一个字符 会因为语言不同而不同 | (x, "HH t", "zh-CN") = 02 上 (x, "HH t", "en-US") = 02 A (x, "HH t", "ja-JP") = 02 午 | |
tt | 上午/下午 会因为语言不同而不同 | (x, "HH tt", "zh-CN") = 02 上午 (x, "HH tt", "en-US") = 02 AM (x, "HH tt", "ja-JP") = 02 午前 | |
y | 是 | 年份(0-99) | (x, "%y", "zh-CN") = 22 |
yy | 年份(00-99) | (x, "yy", "zh-CN") = 22 | |
yyy | 年份(000-9999) 最低3位 | (x, "yyy", "zh-CN") = 2022 | |
yyyy | 年份(0000-9999) | (x, "yyyy", "zh-CN") = 2022 | |
z | 是 | 时区 仅小时,不含分钟 | (x, "%z", "zh-CN") = +8 |
zz | 时区 两位小时,不含分钟 | (x, "zz", "zh-CN") = +08 | |
zzz | 时区 含时分 | (x, "zzz", "zh-CN") = +08:30 | |
: | 是 | 时间分隔符 不一定非要分隔时分秒 | (x, "mm:ss") = 03:56 (x, "yyyy:MM") = 2022:09 |
/ | 是 | 日期分隔符 不一定非要分隔年月日 | (x, "mm:ss") = 03/56 (x, "yyyy:MM") = 2022/09 |
"" 、'' | 字面文本分隔符 保持引号之间的内容不变 | (x, "yyyy'K'") = 2022K (x, "yyyy""K""") = 2022K | |
% | 指示之后的字符是自定义格式说明符% 之后的一个字符和其他字符会分开解析 | (x, "%d") = 5 (x, "d") = 2022/9/5 (x, "%MM") = 99 | |
\\ | 转义符 | (x, "yyyy\K") = 2022K (x, "yyyy\MM") = 2022M9 (x, "yyyy\M\M") = 2022MM | |
其它 | 其他字符保持原样 | (x, "今天是MM/dd") = 今天是09/05 (x, "today is MM/dd") = 上o5a22 i56 09/05 |