通過 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 字段一樣。