NSwag生成API代码时，如何将DateTimeOffset替换为DateTime？

API开发中使用NSwag生成客户端代码时，MeasurementTimeStamp字段被生成为System.DateTimeOffset类型，但实际API返回的Response类中该字段为DateTime类型，需要将生成的字段类型改为System.DateTime。

当前生成的代码 #

[Newtonsoft.Json.JsonProperty("measurementTimeStamp", Required = Newtonsoft.Json.Required.DisallowNull, NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore)]
public System.DateTimeOffset MeasurementTimeStamp { get; set; }

API响应类 #

public class Response {
    public DateTime MeasurementTimeStamp { get; set; }
}

期望生成的代码 #

[Newtonsoft.Json.JsonProperty("measurementTimeStamp", Required = Newtonsoft.Json.Required.DisallowNull, NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore)]
public System.DateTime MeasurementTimeStamp { get; set; }

解决方法 #

方法1：全局修改NSwag配置 #

在NSwag配置文件（如nswag.json）的CSharpClientGeneratorSettings节点中，添加或修改dateTimeType配置为System.DateTime，全局将所有日期时间字段映射为DateTime类型：

{
  "runtime": "Net60",
  "documentGenerator": {
    "fromDocument": {
      "url": "https://your-api-url/swagger/v1/swagger.json",
      "output": null
    }
  },
  "codeGenerators": {
    "csharp": {
      "dateTimeType": "System.DateTime",
      // 保留其他原有配置
    }
  }
}

方法2：针对单个字段修改 #

若仅需修改特定字段，通过自定义Schema处理器实现：

1. 创建Schema处理器类：

public class DateTimeSchemaProcessor : ISchemaProcessor
{
    public void Process(SchemaProcessorContext context)
    {
        if (context.TypeName == "Response" && 
            context.PropertyName == "measurementTimeStamp")
        {
            context.Property.Type = new JsonSchemaType(typeof(DateTime));
            context.Schema.Format = null;
        }
    }
}

2. 在代码生成逻辑中注册该处理器：

var document = await OpenApiDocument.FromUrlAsync("https://your-api-url/swagger/v1/swagger.json");
var settings = new CSharpClientGeneratorSettings();
settings.SchemaProcessors.Add(new DateTimeSchemaProcessor());

var generator = new CSharpClientGenerator(document, settings);
var code = generator.GenerateFile();

方法3：命令行参数指定 #

使用NSwag命令行生成代码时，添加/dateTimeType:DateTime参数：

nswag swagger2csclient /input:swagger.json /output:Client.cs /dateTimeType:DateTime

内容的提问来源于stack exchange，提问作者Jeroen Zwaal