C# 日期时间格式化方法 C#如何格式化DateTime

来源:这里教程网 时间:2026-02-21 17:39:32 作者:

DateTime.ToString() 的基本用法和常见格式字符串

直接调用

ToString()
而不传参,会走当前线程的区域设置(
CultureInfo.CurrentCulture
),结果不稳定。生产环境必须显式指定格式或文化。

"yyyy-MM-dd"
"2024-06-15"
(推荐用于存储、API 传输)
"HH:mm:ss"
"14:30:25"
(24 小时制,注意是
HH
不是
hh
"MM/dd/yyyy HH:mm"
"06/15/2024 14:30"
(注意斜杠是字面量,实际输出受
CultureInfo
影响)
想彻底避免文化影响?用不变文化:
dt.ToString("yyyy-MM-dd HH:mm:ss", System.Globalization.CultureInfo.InvariantCulture)

使用 DateTimeFormatInfo.InvariantInfo 避免本地化干扰

Windows 和 Linux 下默认

CultureInfo.CurrentCulture
表现不一致,尤其在分隔符(如日期中的
/
、时间中的
:
)和 AM/PM 标识上。哪怕你本地测试正常,部署到 Docker 容器或 Ubuntu 服务器就可能出错。

错误写法:
dt.ToString("yyyy/MM/dd") // 在某些文化下 / 可能被替换成其他分隔符
正确写法:
dt.ToString("yyyy'/'MM'/'dd", System.Globalization.DateTimeFormatInfo.InvariantInfo)
更稳妥:用单引号包裹字面量字符,比如
'T'
'Z'
,确保生成 ISO 8601 格式:
dt.ToString("yyyy-MM-dd'T'HH:mm:ss.fff'Z'", System.Globalization.DateTimeFormatInfo.InvariantInfo)

ToString("o") 和 ToString("u") —— 内置标准格式的取舍

"o"
(Round-trip 格式)和
"u"
(Universal sortable)是两个预定义标准格式,但行为差异明显:

"o"
输出带本地时区偏移,如
"2024-06-15T14:30:25.123+08:00"
;依赖
DateTimeKind
,若
dt.Kind == DateTimeKind.Unspecified
,会按本地时区补偏移,容易误判
"u"
强制转为 UTC 并用
"yyyy-MM-dd HH:mm:ssZ"
格式(无毫秒、无冒号、固定
Z
),适合日志排序,但丢失毫秒精度
真正需要跨系统交换时间?优先用
ToString("O")
(注意大写 O)并确保
dt.Kind == DateTimeKind.Utc
,否则先调用
dt.ToUniversalTime()

自定义格式中容易忽略的陷阱

看似简单的格式字符串,实际运行时可能因大小写、重复次数、文化设置而失效。

"yyyy"
是四位年份;
"yy"
是两位,但
"y"
(单个)在某些文化下会报错或返回意外值
"MM"
是月份(01–12);
"mm"
是分钟(00–59)——大小写敏感,拼错就变成“把分钟当月份”
"dddd"
返回完整星期名(如 "Saturday"),但若用
CultureInfo.GetCultureInfo("zh-CN")
,会输出中文,而
InvariantInfo
下返回英文,别假设它总是中文
想输出带毫秒的精确时间?用
"fff"
(三位),不是
"FFF"
"ms"
"ffff"
是万分之一秒,但 .NET 默认只保留毫秒精度,多余位恒为 0

格式化不是“写对字符串就行”,关键是控制输入的

DateTimeKind
、选对文化、明确分隔符是否需转义。哪怕只是写日志,也建议统一用
InvariantInfo
+ 单引号包裹字面量,省去排查环境差异的时间。

相关推荐