通过 swashbuckle webapi 2 C# 在 swagger UI 上的 DataContract 模型中显示 dateTime 数据类型

Question

我正在为模型使用数据合同，并且日期时间数据成员工作正常，但是 swagger ui 将数据类型显示为字符串而不是日期时间。

数据成员示例：

[DataMember(EmitDefaultValue = false, Order = 6), XmlElement(Namespace = apiNameSpace, Order = 6)]
public DateTime? StartDate { get; set; } = null;

swashbuckle swagger-ui 模型输出：

开始日期（字符串，可选）：

Answer 1

这是根据 Swagger 2.0 规范（参见https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md ）。

规范说日期时间应该表示为字符串类型，关联的“格式”属性设置为“日期时间”。

如果您想查看示例，请查看http://petstore.swagger.io/#!/store/placeOrder 。 “shipDate”定义为（字符串，可选），就像您的 StartDate 字段一样。