C#日期和时间DateTime转字符串最佳实践

 更新时间:2025年06月06日 09:50:56   作者:阿蒙Armon  
在 C# 开发中,DateTime类型的时间格式化是高频操作场景,本文将通过 20 + 实战示例,全面解析DateTime转换为字符串的核心方法与最佳实践,感兴趣的朋友一起看看吧

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

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

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

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

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

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

2. 系统时间相关方法

方法示例输出用途说明
ToFileTime()133756416859912816获取 Windows 文件时间(长整型)
ToFileTimeUtc()133756704859912816UTC 格式的文件时间
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)说明
d2023-10-25短日期格式
D2023 年 10 月 25 日长日期格式
t14:30短时间格式
T14:30:45长时间格式
f2023 年 10 月 25 日 14:30完整日期 + 短时间
F2023 年 10 月 25 日 14:30:45完整日期 + 长时间
s2023-10-25T14:30:45ISO 8601 排序日期格式
u2023-10-25 14:30:45ZUTC 通用排序格式
rWed, 25 Oct 2023 14:30:45 GMTRFC 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
HH24 小时制小时(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的 ToStringdate.ToString("D", fr-FR)多语言环境适配
时间戳生成ToUnixTimeSeconds/ToFileTime((DateTimeOffset)date).ToUnixTimeSeconds()数值化时间表示

掌握DateTime的格式化技巧,能有效提升系统在数据交互、日志记录、报表生成等场景的健壮性。建议在实际开发中根据具体需求(如目标系统格式要求、性能敏感度、文化兼容性)选择最合适的转换方案,并通过单元测试确保格式的一致性。

到此这篇关于C#日期和时间DateTime转字符串最佳实践的文章就介绍到这了,更多相关C# DateTime转字符串内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • C# Dynamic关键字之:调用属性、方法、字段的实现方法

    C# Dynamic关键字之:调用属性、方法、字段的实现方法

    本篇文章是对C#中调用属性、方法、字段的实现方法进行了详细的分析介绍,需要的朋友参考下
    2013-05-05
  • [C#].NET中几种Timer的使用实例

    [C#].NET中几种Timer的使用实例

    本篇文章主要介绍了.NET中几种Timer的使用,具有一定的参考价值,有兴趣的可以了解一下。
    2016-12-12
  • c# 模拟串口通信 SerialPort的实现示例

    c# 模拟串口通信 SerialPort的实现示例

    本文主要介绍了c# 模拟串口通信 SerialPort的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-05-05
  • C#设置PDF表单不可编辑以及提取表单数据的操作

    C#设置PDF表单不可编辑以及提取表单数据的操作

    PDF表单是PDF中的可编辑区域,允许用户填写指定信息,当表单填写完成后,有时候我们可能需要将其设置为不可编辑,以保护表单内容的完整性和可靠性,本文将给大家介绍C#设置PDF表单不可编辑以及提取表单数据的操作,需要的朋友可以参考下
    2024-06-06
  • Unity Shader模拟玻璃效果

    Unity Shader模拟玻璃效果

    这篇文章主要为大家详细介绍了Unity Shader模拟玻璃效果,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-05-05
  • c#根据网址抓取网页截屏生成图片的示例

    c#根据网址抓取网页截屏生成图片的示例

    本文主要介绍了c#根据网址抓取网页截屏生成图片并保存的示例,代码中使用了WebBrowser控件来完成这个功能,大家参考使用吧
    2014-01-01
  • C# List中FindAll用法的一些简单示例

    C# List中FindAll用法的一些简单示例

    本篇文章只要是对C# List中FindAll用法的一些简单示例进行了介绍,需要的朋友可以过来参考下,希望对大家有所帮助
    2014-01-01
  • C#定义简单的反射工厂实例分析

    C#定义简单的反射工厂实例分析

    这篇文章主要介绍了C#定义简单的反射工厂的用法,实例分析了反射工厂的原理与使用技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-04-04
  • C#列出当前系统所有正在运行程序的方法

    C#列出当前系统所有正在运行程序的方法

    这篇文章主要介绍了C#列出当前系统所有正在运行程序的方法,涉及C#操作系统进程的技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-04-04
  • Devexpress treelist 简介

    Devexpress treelist 简介

    本文给大家简单介绍了Devexpress treelist 知识,包括属性列表,事件及使用方法,非常不错,具有参考借鉴价值,需要的朋友参考下
    2016-12-12

最新评论