日期、周、月、季度、年使用同一套日期选择配置。具体字段类型决定用户选择的是日、周、月、季度还是年。
当字段值表示日历日期或报表周期,而不是精确到时分秒的时刻时,可以使用这些字段。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签,必填;名称应清楚表达日期或周期含义 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称,必填 |
| 必填 | 保存记录前必须选择一个值 |
| 只读 | 展示所选值,但不允许用户修改 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存所选值,但不在常规表单页面展示 |
日期选择配置
| 配置项 | 说明 |
|---|
| 占位提示 | 用户选择值前显示在字段中的提示文案 |
| 选择模式 | 控制选择单个值、范围或多个值 |
| 格式 | 选中值的展示格式 |
| 范围开始可为空 | 允许范围开始值为空 |
| 范围结束可为空 | 允许范围结束值为空 |
| 最小边界 | 当前选择类型允许选择的最早值 |
| 最大边界 | 当前选择类型允许选择的最晚值 |
| 最小边界提示 | 所选值早于最小边界时显示的自定义提示 |
| 最大边界提示 | 所选值晚于最大边界时显示的自定义提示 |
| 周末提示 | 禁用周末时显示的自定义提示 |
| 校验时机 | 控制什么时候执行校验:值变更时、失焦时或提交记录时 |
| 输入状态 | 给输入框添加警告或错误等视觉状态 |
| 输入只读 | 禁止手动输入,只允许通过选择器选择 |
| 禁用过去时间 | 禁止选择过去的值 |
| 禁用未来时间 | 禁止选择未来的值 |
| 禁用今天 | 禁止选择今天 |
| 禁用周末 | 禁止选择周末 |
| 颜色 | 设置字段展示颜色 |
| 帮助文案 | 展示在字段附近的辅助说明;可用于说明日期规则或业务含义 |
字段类型区别
| 字段类型 | 选择含义 |
|---|
| 日期 | 一个日期、日期范围或多个日期 |
| 周 | 一个周、周范围或多个周 |
| 月 | 一个月、月范围或多个月 |
| 季度 | 一个季度、季度范围或多个季度 |
| 年 | 一个年、年范围或多个年 |
配置建议
| 建议 | 说明 |
|---|
| 格式匹配字段类型 | 月字段使用月格式,年字段使用年格式,避免展示含义不一致 |
| 周期场景使用范围 | 日期窗口、报表周期等场景适合范围模式 |
| 严格选择时开启输入只读 | 避免用户手动输入不符合预期格式的值 |
| 设置边界提示 | 自定义提示能让用户更容易理解日期限制 |