在 swagger UI 中遇到日期时间问题

编程问答 2022-05-31

问题描述

enter image description here

我正在使用 swagger UI 在查询字符串中传递日期时间 31-05-2019 23:59:59 但收到无效日期时间的异常。请参阅附件截图。

解决方法

DateTime 必须符合 ISO-8601 format，即 yyyy-MM-dd'T'HH:mm:ssZ，因此在将日期时间传递给查询之前，您应该将日期时间更改为 2019-05-31T23:59:59Z。请注意，Z 代表 Zulu 并指定 UTC+00:00。如果您的日期时间值具有其他区域偏移量，请在格式中指定，("+" / "-") time-hour ":" time-minute 例如2019-05-31T23:59:59+05:30 指定日期时间，时区偏移为 5 小时 30 分钟（印度标准时间）。

以下是Swagger Data Types的摘录：

字符串格式

optional 格式修饰符用作字符串内容和格式的提示。 OpenAPI 定义了以下内置字符串格式：

  • date – RFC 3339 第 5.6 节定义的完整日期表示法，例如 2017-07-21
  • date-time – RFC 3339 第 5.6 节定义的日期时间表示法，例如 2017-07-21T17:32:28Z
datedatetime-formatformatswagger-uitimetime