1 功能简介
月份选择控件适用于在数据填报时需要选择某年某月不需要细化到具体日期的场景,对月份的存储格式也相对比较灵活,支持按日期格式存储(固定存储为某年某月1日),也支持使用字符串或整型自由定义存储格式,例如“2024年2月”、“2024/02”或“202402”等。
2 配置说明
常规设置:
根据字段在数据库中存储的数据类型不同,月份控件常规配置界面有所不同,大致分为以下两类:
(1)字段数据类型为“日期型”或“(长)整型”:
- 当数据类型为“日期型”时,我们约定了日期类型的数据存储格式为所选月份的1日,即yyyy-MM-01;
- 当数据类型为“整型”或“长整型”时,我们约定了日期类型的数据存储格式为yyyyMM。
- 可选范围:允许配置控件填报时允许选择的最早/最晚可选月份,默认均不勾选,勾选后值必填,支持配置固定年月或通过表达式配置。
- 固定值:输入符合格式yyyy-MM的月份,例如2024-01;
- 自定义:通过前端表达式配置年月,表达式返回格式需符合格式”yyyy-MM”字符串。注意:选择“自定义”方式下默认读取的是字符串,如果需要直接填写月份建议使用“固定值”方式或在填写的月份上添加英文引号。
(2)字段数据类型使用“字符型”:
- 字段数据类型为“字符型”也可以选择使用月份选择控件,可选范围配置同上文,只不过此时需要额外指定月份控件对数据的读写格式,可以在【格式设置】设置。
- 打开【格式设置】可以看到数据默认的格式为yyyyMM,可以在预设的选项中快速选择需要使用的格式,也可以点击【自定义】去自己编辑想要的读写格式,例如yyyy/MM 、yyyy-MM 、yyyy年MM月等。
显示与布局:
- 详细配置说明请查阅章节 元数据>字段显示与布局
高级设置:
- 支持控件高级设置、校验设置、自动赋值设置和字段高级设置等,详细配置说明请查阅章节 元数据>字段高级设置
3 显示交互
PC端编辑样式::
移动端编辑样式:
限制可选范围样式:
例如需要限制可选范围仅支持选择本年范围内选择月份可以如下配置。
- 最早可选:表达式formatDatetime(now(),”yyyy-01”) ,返回本年1月。
- 最晚可选:表达式formatDatetime(now(),”yyyy-12”) ,返回本年12月。
执行效果如下:
作者:Eric 创建时间:2023-08-08 13:49
最后编辑:Eric 更新时间:2025-04-24 13:55
最后编辑:Eric 更新时间:2025-04-24 13:55
