时间类型
说明
时间类型分为起止日期(例如10月1日-10月7日)和单一日期(仅10月1日)两种场景。当处于单一日期场景时,startTime和entTime会存储相同的值。
响应参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| startTime | long | 是 | 开始时间(毫秒时间戳) |
| endTime | long | 是 | 结束时间(毫秒时间戳) |
| startTimeZoneId | String | 否 | 开始时间时区,采用 IANA 时区标识,例如 Asia/Shanghai、America/New_York。无时区信息时为 null |
| endTimeZoneId | String | 否 | 结束时间时区,采用 IANA 时区标识,例如 Asia/Shanghai、America/New_York。无时区信息时为 null |
时区说明:
startTime/endTime均为 UTC 毫秒时间戳。当startTimeZoneId/endTimeZoneId不为空时,可结合时区将时间戳还原为用户填写时的本地时间;为空表示该时间未携带时区信息(历史数据或表单未开启时区)。
参数样例
{
"startTime": 1546272000000,
"endTime": 1548950400000,
"startTimeZoneId": "Asia/Shanghai",
"endTimeZoneId": "Asia/Shanghai"
}
修改记录
2023-02-08 新增时间类型文档
2026-06-26 新增 startTimeZoneId、endTimeZoneId 时区字段