CsvHelper全局设置日期输出格式问题（.NET Core 6.0迁移）

问题背景 #

升级旧.NET应用至.NET Core 6.0时同步升级了CsvHelper，原代码通过TypeConverterCache和TypeConverterOptionsCache全局配置所有日期字段输出格式的方式已失效，且网上多数方案要求逐个配置DTO字段，操作繁琐，需寻求全局配置方案。

原旧代码示例：

using (var writer = new StreamWriter(writeStream))
{
    var items = type?.GetProperty("Data")?.GetValue(value, null) as IEnumerable;
    var csvWriter = new CsvWriter(writer);

    csvWriter.Configuration.TypeConverterCache.AddConverter<Date>(new DateConverter());
    var dateTimeOptions = new TypeConverterOptions
            {
                Formats = new [] { FormatConstants.DefaultDateTimeFormat }
            };
            
    csvWriter.Configuration.TypeConverterOptionsCache.AddOptions(typeof(DateTimeOffset), dateTimeOptions);
    csvWriter.Configuration.TypeConverterOptionsCache.AddOptions(typeof(DateTime), dateTimeOptions);
    csvWriter.WriteRecords(items);
}

解决方案 #

在当前CsvHelper版本（v30+）中，可通过CsvConfiguration对象集中配置全局类型转换器及选项，无需逐个字段设置：

1. 创建并配置CsvConfiguration #

通过CsvConfiguration统一设置日期类型的输出格式，并注册自定义转换器：

// 初始化配置，指定文化信息（按需调整）
var config = new CsvConfiguration(CultureInfo.InvariantCulture);

// 针对DateTime类型配置输出格式
config.TypeConverterOptions.Add<DateTime>(options =>
{
    options.Formats = new[] { FormatConstants.DefaultDateTimeFormat };
});

// 针对DateTimeOffset类型配置输出格式
config.TypeConverterOptions.Add<DateTimeOffset>(options =>
{
    options.Formats = new[] { FormatConstants.DefaultDateTimeFormat };
});

// 注册自定义Date类型转换器
config.TypeConverters.AddConverter<Date>(new DateConverter());

2. 使用配置创建CsvWriter #

将配置传入CsvWriter构造函数，即可应用全局设置：

using (var writer = new StreamWriter(writeStream))
using (var csvWriter = new CsvWriter(writer, config))
{
    var items = type?.GetProperty("Data")?.GetValue(value, null) as IEnumerable;
    csvWriter.WriteRecords(items);
}

说明 #

• 此方式会对所有DTO中DateTime、DateTimeOffset类型的字段自动应用指定格式，无需在每个DTO上单独配置。
• 若需针对特定字段覆盖全局配置，仍可通过ClassMap的Map方法单独设置优先级更高的格式。

内容的提问来源于stack exchange，提问作者Jim Robson