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

【问题标题】：show dateTime dataType in DataContract model on swagger UI via swashbuckle webapi 2 C#通过 swashbuckle webapi 2 C# 在 swagger UI 上的 DataContract 模型中显示 dateTime 数据类型
【发布时间】：2015-08-29 21:19:04
【问题描述】：

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

数据成员示例：

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

swashbuckle swagger-ui 模型输出：

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

【问题讨论】：

标签： datetime asp.net-web-api2 swagger swagger-ui swashbuckle

【解决方案1】：

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

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

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

【讨论】：