日期

1. 组件概述

日期是一个数据输入组件，用于让用户选择日期或时间。它提供了一个日历面板供用户点选，支持多种日期类型（日期、日期时间、时间、月份、季度、年份），并可以设置日期范围限制。日期组件是时间相关表单的基础组件，适用于需要用户输入日期信息的各种场景。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：收集用户出生日期。在学生信息登记表中，使用日期组件让用户选择出生日期。设置「日期类型」为「日期」，配置「最大值」为当前日期（防止选择未来日期），并设置「绑定变量」为 birthday，工作流可以根据此变量计算年龄或进行其他处理。
• 场景二：设置任务截止时间。在学习计划类应用中，用户需要为学习任务设置截止时间。选择「日期类型」为「日期时间」，设置「最小值」为当前时间（防止选择过去的时间），用户选择后触发工作流，AI 可以根据截止时间提供学习建议或发送提醒。

加载中...

查看 JSON

复制 JSON

3. 功能配置

高级

基本折叠组

配置项	说明
绑定变量	组件的变量名，用户选择的日期值会以此变量名存储。其他组件可以绑定此变量来显示日期值，调用工作流时此变量的值也会传递给工作流。
标题	显示在日期选择器左侧的标签文字，用于说明该输入项的用途，如「出生日期」、「截止时间」。
日期类型	选择日期选择器的类型，决定用户可以选择的时间精度。可选项包括：「日期」（年月日）、「日期时间」（年月日时分秒）、「时间」（时分）、「月份」（年月）、「季度」（年季度）、「年份」（年）。切换类型后，显示格式和占位提示会自动调整。
值格式	设置日期值的存储格式，即提交给工作流时的数据格式。默认为「X」（时间戳），也可以选择其他格式如「YYYY-MM-DD」。时间戳格式便于后端处理和计算，日期字符串格式更易读。
显示格式	设置日期在界面上的显示格式。例如「YYYY-MM-DD」显示为「2024-01-15」，「YYYY年MM月DD日」显示为「2024年01月15日」。显示格式不影响实际存储的值。
UTC转换	开启后，提交数据和展示数据将进行 UTC 时间转换。如果你的应用有跨时区用户（如国际学校的师生），建议开启此选项以确保时间的一致性。
可清除	开启后，日期选择器右侧会显示清除按钮，用户可以一键清空已选择的日期。默认开启。
禁止输入	开启后，用户只能通过点击日历面板选择日期，不能直接在输入框中手动输入日期。适用于需要严格控制日期格式的场景。
默认值	设置日期选择器的初始值。可以设置为静态日期，也可以使用相对值，如「now」表示当前时间，「+3days」表示三天后，「-1week」表示一周前。支持的单位包括：minute、hour、day、week、month、year 等。
最小值	限制用户可选择的最早日期。早于此日期的选项会被禁用。可以设置为静态日期或相对值，如「now」表示不能选择过去的日期。
最大值	限制用户可选择的最晚日期。晚于此日期的选项会被禁用。可以设置为静态日期或相对值，如「now」表示不能选择未来的日期。
占位提示	日期选择器为空时显示的灰色提示文字，引导用户操作。默认根据日期类型自动设置，如「请选择日期」、「请选择时间」等。
控件提示	在日期选择器旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合解释该日期字段的用途或填写要求。
描述	显示在日期选择器下方的浅色说明文字，用于补充解释该配置项的用途或填写要求。

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见。
隐藏	控制组件是否隐藏。与「可见」相反。
禁用	控制组件是否禁用（变灰且不可操作）。
静态展示	开启后，日期选择器变为只读的纯文本展示模式，不可编辑。适用于详情页或确认页面。
隐藏时删除字段	开启后，当该组件被隐藏时，其值会从表单数据中删除。适用于条件显示的字段，避免提交无关数据。

校验折叠组

配置项	说明
必填	开启后，该日期字段必须填写才能提交表单。

设计

其他折叠组

配置项	说明
模式	日期选择器的展示模式。「浮层」模式下，点击输入框后弹出日历面板；「内嵌」模式下，日历面板直接显示在页面上，无需点击触发。内嵌模式适合日期选择是页面核心功能的场景。

事件

事件折叠组

配置项	说明
添加事件	支持「值变化」、「获取焦点」、「失去焦点」三种触发事件。「值变化」事件在用户选择日期后触发，常用于根据选择的日期动态更新其他内容或调用工作流。「获取焦点」和「失去焦点」事件在输入框获得或失去焦点时触发（仅在浮层模式下有效）。