Hybris swagger UI 日期时间示例格式

Question

我有一个 Hybris 项目，我们通过 swagger + swagger-ui 提供一个宁静的 API。我们遇到日期时间属性和参数的格式问题。显示格式如下：“2018-06-22T08:00:19.130Z”。

但是，我们使用并需要在 swagger-ui 提供的示例中显示的格式是“2018-06-22T08:00:19Z”。

参数是 DTO 由 spring 自动生成的。

关于如何更改示例的日期时间格式有什么想法吗？

谢谢，克里斯

Answer 1

这很大程度上取决于您拥有的 swagger-ui 版本，这些示例并不总是受支持，因此我下面的示例假设您使用的是最新和最好的（如果不是，您应该考虑升级）。

如果需要在查询参数中显示它，则需要设置默认值：

      "parameters": [
      {
        "name": "data.d1",
        "in": "query",
        "required": false,
        "type": "string",
        "format": "date-time",
        "default": "2018-06-22T08:00:19Z",
      }

对于定义来说只是example：

"definitions": {
 "Data": {
  "properties": {
    "date0": {
      "example": "2018-06-22T08:00:19Z",
      "type": "string",
      "format": "date-time"
    }

这是类似的东西的样子

以下是实时版本的链接：
http://petstore.swagger.io/? url=https://raw.githack.com/heldersepu/hs-scripts/master/swagger/swagger_51019812.json#/ApiExplorer/ApiExplorer_Get