当前位置：首页 > news >正文

C#日期和时间：DateTime转字符串全面指南

news 2025/5/24 6:49:13

C#日期和时间：DateTime转字符串全面指南

在 C# 开发中，DateTime类型的时间格式化是高频操作场景。无论是日志记录、数据持久化，还是接口数据交互，合理的时间字符串格式都能显著提升系统的可读性和兼容性。本文将通过 20 + 实战示例，全面解析DateTime转换为字符串的核心方法与最佳实践。

一、基础转换方法：快速获取常用格式

1. 无参 ToString ()：本地化默认格式

DateTime.Now.ToString(); // 2023-10-25 14:30:45（依赖系统区域设置）

该方法返回基于当前系统文化设置的默认格式，适用于快速调试，但不建议用于跨环境交互。

2. 系统时间相关方法

方法	示例输出	用途说明
`ToFileTime()`	133756416859912816	获取 Windows 文件时间（长整型）
`ToFileTimeUtc()`	133756704859912816	UTC 格式的文件时间
`ToLocalTime()`	2023-10-25 22:30:45	转换为本地时区时间
`ToUniversalTime()`	2023-10-25 06:30:45	转换为 UTC 时间

3. 预定义格式方法

DateTime.Now.ToLongDateString(); // "2023年10月25日"（中文环境）
DateTime.Now.ToShortDateString(); // "2023-10-25"
DateTime.Now.ToLongTimeString(); // "14:30:45"
DateTime.Now.ToShortTimeString(); // "14:30"

这些方法提供了日期和时间的粗细粒度划分，适用于需要快速生成特定格式的场景。

二、自定义格式字符串：精准控制输出

1. 标准格式说明符（单个字符）

通过ToString(string format)或string.Format使用格式字符：

格式符	示例（2023-10-25 14:30:45）	说明
`d`	2023-10-25	短日期格式
`D`	2023 年 10 月 25 日	长日期格式
`t`	14:30	短时间格式
`T`	14:30:45	长时间格式
`f`	2023 年 10 月 25 日 14:30	完整日期 + 短时间
`F`	2023 年 10 月 25 日 14:30:45	完整日期 + 长时间
`s`	2023-10-25T14:30:45	ISO 8601 排序日期格式
`u`	2023-10-25 14:30:45Z	UTC 通用排序格式
`r`	Wed, 25 Oct 2023 14:30:45 GMT	RFC 1123 标准格式

示例代码：

DateTime.Now.ToString("s"); // "2023-10-25T14:30:45"（适合API返回）
string.Format("{0:u}", DateTime.Now); // "2023-10-25 14:30:45Z"（UTC标准化）

2. 自定义格式符（组合字符）

通过组合yyyy/MM/dd HH:mm:ss等字符实现任意格式：

字符	说明	示例（2023-10-25 14:30:45）
`yyyy`	四位数年份	2023
`MM`	两位数月份（01-12）	10
`dd`	两位数日期	25
`HH`	24 小时制小时（00-23）	14
`mm`	分钟（00-59）	30
`ss`	秒（00-59）	45
`fff`	毫秒（000-999）	450

复杂示例：

// 生成带毫秒的日志时间戳
DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff"); // "2023-10-25 14:30:45.450"// 生成Excel兼容的日期时间
DateTime.Now.ToString("yyyy/mm/dd hh:mm:ss tt"); // "2023/10/25 02:30:45 下午"（带AM/PM标识）

三、高级时间操作与格式处理

1. 时间偏移与计算

通过Add系列方法实现时间加减后格式化：

// 增加1.5天（36小时）
DateTime.Now.AddDays(1.5).ToString("yyyy-MM-dd HH:mm"); // "2023-10-27 02:30"// 增加10000 ticks（1毫秒=10000 ticks）
DateTime.Now.AddTicks(10000).ToString("yyyy-MM-dd HH:mm:ss.fff"); // 精确到毫秒级增量

2. 多文化格式支持

通过CultureInfo指定非默认文化格式：

using System.Globalization;// 生成法语格式日期
DateTime.Now.ToString("D", CultureInfo.CreateSpecificCulture("fr-FR")); // "25 octobre 2023"// 生成日本格式时间
DateTime.Now.ToString("t", CultureInfo.GetCultureInfo("ja-JP")); // "14:30"

3. 特殊格式处理

需求场景	实现代码	输出示例
生成 ISO 8601 完整格式	`DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ")`	“2023-10-25T06:30:45+08:00”
去除时间部分	`DateTime.Now.Date.ToString("yyyy-MM-dd")`	“2023-10-25”
生成时间戳（秒级）	`((DateTimeOffset)DateTime.Now).ToUnixTimeSeconds().ToString()`	“1698220245”
生成时间戳（毫秒级）	`((DateTimeOffset)DateTime.Now).ToUnixTimeMilliseconds().ToString()`	“1698220245450”

四、常见问题与最佳实践

1. 时区转换陷阱

UTC 与本地时间：始终明确时间的时区属性，避免混合使用ToLocalTime()和ToUniversalTime()
跨平台兼容性：优先使用ISO 8601格式（如s/u/r），避免依赖系统区域设置

2. 性能优化

高频转换场景使用StringBuilder而非字符串拼接
预定义格式字符串可缓存重用，避免重复解析

3. 空值处理

DateTime? nullableDate = null;
string result = nullableDate?.ToString("yyyy-MM-dd") ?? "未指定时间"; // 安全转换

4. 单元测试建议

对关键格式进行断言测试：

var date = new DateTime(2023, 10, 25, 14, 30, 45);
Assert.AreEqual("2023-10-25", date.ToString("d"));
Assert.AreEqual("25 octobre 2023", date.ToString("D", CultureInfo.French));

五、总结：选择合适的格式化方案

场景分类	推荐方法	示例代码	优势特点
快速调试	`ToString()`	`DateTime.Now.ToString()`	无需参数，快速查看
标准化输出	标准格式符（如 “s”/“u”）	`date.ToString("s")`	跨平台兼容
自定义格式	自定义格式字符串	`date.ToString("yyyy/MM/dd HH:mm")`	灵活控制输出样式
跨文化支持	带`CultureInfo`的 ToString	`date.ToString("D", fr-FR)`	多语言环境适配
时间戳生成	`ToUnixTimeSeconds`/`ToFileTime`	`((DateTimeOffset)date).ToUnixTimeSeconds()`	数值化时间表示