在 Swagger 中,日期时间格式的表示方式是 ISO 8601 标准。具体写法如下:
- 年月日:YYYY-MM-DD
- 时间:HH:mm:ss
- 时区:Z 表示 UTC+0
例如,完整的日期时间格式为:
2022-01-01T12:34:56Z
其中,T
是日期和时间的分隔符。
在 Swagger 中使用这种日期时间格式,可以在 API 文档中明确指定请求参数和响应结果的数据类型。例如:
parameters:
- name: startTime
in: query
description: 开始时间
required: true
schema:
type: string
format: date-time # 使用 ISO 8601 格式表示日期时间
responses:
'200':
description: 成功返回
content:
application/json:
schema:
type: object
properties:
createTime:
type: string
format: date-time # 使用 ISO 8601 格式表示日期时间
description: 创建时间