时间字段用于保存一天中的一个时间值或时间范围。它不保存具体日历日期。
每日排班、截止时间、班次时间、预约时间段，或任何按一天内时间重复的值，都适合使用时间字段。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签，必填；名称应清楚表达这个时间的业务含义 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填 |
| 必填 | 保存记录前必须选择时间 |
| 只读 | 展示所选时间，但不允许用户修改 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存时间，但不在常规表单页面展示 |
时间字段配置
| 配置项 | 说明 |
|---|
| 占位提示 | 用户选择时间前显示在字段中的提示文案 |
| 选择模式 | 控制选择单个时间或时间范围 |
| 格式 | 选中时间的展示格式 |
| 范围开始可为空 | 允许范围开始值为空 |
| 范围结束可为空 | 允许范围结束值为空 |
| 最小时间 | 允许选择的最早时间 |
| 最大时间 | 允许选择的最晚时间 |
| 最小时间提示 | 所选时间早于最小时间时显示的自定义提示 |
| 最大时间提示 | 所选时间晚于最大时间时显示的自定义提示 |
| 小时步长 | 选择器中小时的间隔 |
| 分钟步长 | 选择器中分钟的间隔 |
| 秒步长 | 选择器中秒的间隔 |
| 校验时机 | 控制什么时候执行校验：值变更时、失焦时或提交记录时 |
| 输入状态 | 给输入框添加警告或错误等视觉状态 |
| 颜色 | 设置字段展示颜色 |
| 输入只读 | 禁止手动输入，只允许通过选择器选择 |
| 使用 12 小时制 | 开启后按 12 小时制展示时间 |
| 帮助文案 | 展示在字段附近的辅助说明；可用于说明排班或截止规则 |
常见示例
| 场景 | 建议配置 |
|---|
| 工作班次 | 范围模式，分钟步长 15 |
| 每日截止时间 | 单选模式，格式 HH:mm |
| 预约时间段 | 范围模式，按预约规则设置小时和分钟步长 |
配置建议
| 建议 | 说明 |
|---|
| 用步长减少无效选择 | 小时、分钟、秒步长可以把用户限制在预期时间间隔内 |
| 时间段使用范围模式 | 开始和结束时间用范围模式更清楚 |
| 设置业务时间边界 | 例如 09:00 到 18:00，避免用户选择营业时间外的值 |