C#怎么将DateTime格式化？如何输出带毫秒的自定义时间字符串

在C#开发中，DateTime类型的时间格式化是非常基础且常用的操作，很多场景下需要输出包含毫秒的自定义时间字符串，比如日志记录、接口时间戳传递等场景，掌握正确的格式化方法能避免很多不必要的调试问题。

DateTime格式化的基础规则

DateTime的格式化主要通过ToString()方法实现，该方法支持传入格式字符串参数，既可以识别内置的标准格式符，也支持自定义格式符组合。标准格式符是系统预定义好的固定格式，比如d代表短日期，T代表长日期加长时间，但标准格式符无法灵活控制是否包含毫秒，因此自定义格式字符串是输出带毫秒时间的主要方式。

常用自定义格式符说明

自定义格式字符串由单个字符的格式符组成，每个格式符对应时间的一个部分，以下是和时间相关的常用格式符：

• y：年份，1-4个y分别表示1-4位年份
• M：月份，1-2个M表示月份数字，不补零或补零
• d：日期，1-2个d表示日期数字，不补零或补零
• H：小时，24小时制，1-2个H表示小时数字，不补零或补零
• h：小时，12小时制，1-2个h表示小时数字，不补零或补零
• m：分钟，1-2个m表示分钟数字，不补零或补零
• s：秒，1-2个s表示秒数字，不补零或补零
• f：毫秒，1-3个f分别表示1-3位毫秒数字，更多f会补零到对应位数

输出带毫秒的自定义时间字符串实现

要输出带毫秒的时间字符串，只需要在自定义格式字符串中加入f相关的格式符即可，毫秒的位数由f的数量决定。以下是不同精度毫秒的格式化示例：

示例代码

using System;

namespace DateTimeFormatDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 获取当前时间
            DateTime now = DateTime.Now;
            Console.WriteLine("当前时间：" + now);

            // 输出3位毫秒的时间字符串，格式：年-月-日 时:分:秒.毫秒
            string format1 = "yyyy-MM-dd HH:mm:ss.fff";
            string result1 = now.ToString(format1);
            Console.WriteLine("3位毫秒格式：" + result1);

            // 输出2位毫秒的时间字符串
            string format2 = "yyyy/MM/dd HH:mm:ss.ff";
            string result2 = now.ToString(format2);
            Console.WriteLine("2位毫秒格式：" + result2);

            // 输出1位毫秒的时间字符串
            string format3 = "yyyy年MM月dd日 HH时mm分ss秒f毫秒";
            string result3 = now.ToString(format3);
            Console.WriteLine("1位毫秒格式：" + result3);

            // 输出补零到7位的毫秒（f最多支持7个，对应DateTime的tick精度）
            string format4 = "HH:mm:ss.ffffff";
            string result4 = now.ToString(format4);
            Console.WriteLine("7位毫秒格式：" + result4);
        }
    }
}

代码说明

上述代码中，yyyy-MM-dd HH:mm:ss.fff是最常用的带毫秒的时间格式，其中fff表示输出3位毫秒，不足3位时会补零。如果只需要1位毫秒，使用f即可，系统会自动截取毫秒的第一位数字。需要注意HH是24小时制，如果需要12小时制可以换成hh，同时可以搭配tt格式符输出上午/下午标识。

注意事项

• 格式符的大小写是敏感的，比如M代表月份，m代表分钟，不要写混导致格式化结果错误。
• 自定义格式字符串中的非格式符字符会被原样输出，比如连接符-、:、.都会直接显示在结果中。
• DateTime的毫秒精度是最高到7位（对应tick的一部分），但大部分场景下使用3位毫秒已经足够，更多位的毫秒通常是补零得到的。
• 如果需要固定区域的时间格式，可以在ToString方法中传入IFormatProvider参数，比如CultureInfo.InvariantCulture避免不同系统区域设置导致的格式差异。

常见自定义格式对照表

以下是几种常用的带毫秒的时间格式和对应输出示例：

C#DateTime时间格式化自定义时间字符串修改时间：2026-07-02 22:18:40