1.1 应用场景
1.1.1 填报控件
填报报表中，选择一个日期填入。如下图所示：
1.1.2 参数控件
报表中添加日期查询控件，可以查询指定日期区间内的报表数据。如下图所示：
1.2 如何添加
1.2.1 填报控件
选中单元格后，点击右侧属性面板的「控件设置」，选择控件处下拉选择「日期控件」，如下图所示：
1.2.2 参数控件
将参数面板控件工具栏中的「日期
控件
」拖入到参数面板中，如下图所示：
1.3 使用说明
国外普遍认为一个星期从周日开始，而国内普遍认为一个星期从周一开始，为了满足国内外用户使用习惯，「日期控件」 提供了星期切换功能。
浏览器使用「日期控件」的时候，点击
周一
即可将周一排在一个星期的第一天，点击
周日
将周日排在一个星期的第一天。如下图所示：
不同的星期模式，「日期控件」中显示的周数也会不同。如选择默认的周日作为一星期开始的模式时，每年的第一个周日之前的日子会被计算为上一年的星期数，即第52、53周。如下图所示：
2.1 属性
2.1.1 填报控件
添加「日期控件」后，可在右下方设置日期控件的属性。如下图所示：
各属性设置项的详细介绍如下：
注1：「日期控件」在填报应用时，可通过在单元格中添加日期值的方式设置默认值，如输入 2021-06-21。
注2：给「
日期控件
」赋值的时候，比如默认值、起始日期、结束日期等，为准确识别，建议都使用 yyyy-MM-dd 的日期格式。
分类
|
设置项
|
详细介绍
|
|
基本
|
控件名称
|
控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为无。
|
|
可 用
|
控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。
|
|
可 见
|
控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。
|
高级
|
格 式
|
日期控件的支持的输入格式，日期型和时间型，默认为日期型。
注1：用户可以通过修改日期格式代码来修改日期控件的选项类型，如下修改类型为 “yyyy-MM”，则控件显示为月份控件：
注2：年份控件设置可参考：
年份选择控件插件
1）日期型：用户可以在
年月日
的范围内定义查询日期格式。
2）时间型：用户可以在
年月日时分秒
范围内定义查询日期格式。
|
|
起始日期
|
控件支持选择的日期范围的起始日期，即可以选择的最小日期值。设定后，不在范围内的数据将变成灰色不可选取状态。
有 3 种类型，默认为无
1）无：不做限制
2）日期：可以选择一个特定的日期
3）公式：直接写入公式值，如 A1 单元格为一个日期值，这里写 A1，即可引用这个日期值
注：当日期控件有默认值时，设置的起始日期不生效，必须要重新选择才会生效。
控件默认值生效逻辑请参见：
控件默认值
|
|
结束日期
|
控件支持选择的日期范围的结束日期，即可以选择的最大日期值。设定后，不在范围内的数据将变成灰色不可选取状态，支持的类型和「起始日期」相同。
|
|
水 印
|
填报时控件内显示的浅灰色水印文字，
手动输入，
以提示用户需要输入的信息，点击控件编辑区域后消失，默认为空。
|
|
返回值类型
|
选择后，返回值的格式，分为日期和字符串两种，需要跟数据库表中日期字段的类型匹配。
1）日期：返回值类型是日期型
2）字符串：返回值类型为字符串
|
|
校验
|
允许为空
|
是否允许控件不选择项，勾选后，允许控件不选择；不勾选，填报校验和提交时会提示，默认勾选。
|
|
错误提示
|
不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空
|
|
允许直接编辑
|
是否允许用户直接输入值，勾选后，用户可以直接输入值，默认勾选。
注：此功能不支持移动端。
|
2.1.2 参数控件
添加「日期控件」后，可在右下方设置日期控件的属性。如下图所示：
各属性设置项的详细介绍如下：
注：给「
日期控件
」赋值的时候，比如默认值、起始日期、结束日期等，为准确识别，建议都使用 yyyy-MM-dd 的日期格式。
分类
|
设置项
|
详细介绍
|
|
基本
|
控件名称
|
控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，
默认为 dateEditor# 。
|
|
可 用
|
控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，
默认勾选。
|
|
可 见
|
控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，
默认勾选。
|
|
高级
|
标签名称
|
控件的标签属性是用在移动端的，移动端不支持参数面板上的「标签控件」，识别的是普通控件的「标签名称」属性，所以移动端可以用控件的标签名称来实现标签 。
|
|
控 件 值
|
控件初始化时的默认值，支持日期、公式、字段，
默认当天日期。
1）日期：日期型，可以选择一个日期，如下：
3）公式：设计器支持的公式，例如： A1 单元格为一个日期值，这里写 A1。
如果希望日期控件默认值为空，则可以用公式输入一个空字符串：'' 来实现。
2）字段：数据集字段，数据集包括模板数据集和服务器数据集。例如：数据集 ds1 的时间字段。
|
|
格式
|
日期控件的支持的输入格式，日期型和时间型，默认为日期型。
注1：用户可以通过修改日期格式代码来修改日期控件的选项类型，如下修改类型为 “yyyy-MM”，则控件显示为月份控件：
注2：年份控件设置可参考：
年份选择控件插件
1）日期型：用户可以在
年月日
的范围内定义查询日期格式。
2）时间型：用户可以在
年月日时分秒
范围内定义查询日期格式。
|
|
起始日期
|
控件支持选择的日期范围的起始日期，即可以选择的最小日期值。设定后，不在范围内的数据将变成灰色不可选取状态。
有 3 种类型，默认为无
1）无：不做限制
2）日期：可以选择一个特定的日期
3）公式：直接写入公式值，如 A1 单元格为一个日期值，这里写 A1，即可引用这个日期值
|
|
结束日期
|
控件支持选择的日期范围的结束日期，即可以选择的最大日期值。设定后，不在范围内的数据将变成灰色不可选取状态，支持的类型和「起始日期」相同。
|
水印
|
填报时控件内显示的浅灰色水印文字，
手动输入，
以提示用户需要输入的信息，点击控件编辑区域后消失，默认为空。
|
|
字体大小
|
显示待选项的字体大小，
默认为 12
。
注：此功能不支持移动端。
|
|
返回值类型
|
选择后，返回值的格式，分为日期、字符串。
1）日期：返回值类型是日期类型，和数据库字段相关。
2）字符串：返回值类型是字符串，和数据库字段相关。
|
|
校验
|
允许为空
|
是否允许控件不选择项，勾选后，允许控件不选择；不勾选，填报校验和提交时会提示，默认勾选。
|
|
错误提示
|
不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空
|
|
允许直接编辑
|
是否允许用户直接输入值，勾选后，用户可以直接输入值，默认勾选。
注：此功能不支持移动端。
|
|
坐标.尺寸
|
控件位置
|
控件在参数面板中的位置，通过横纵坐标调整，坐标会根据控件在参数面板中的位置自动显示。
|
|
控件大小
|
控件的大小，通过宽度、高度调整，若通过拖拽调整，高宽度也随着自动调整。
|
2.2 事件
事件设置界面可以为控件添加事件实现某些效果，「日期控件」支持的事件有初始化后、编辑后、编辑结束。如下图所示：
选择一种事件类型后，即可添加事件内容，「日期控件」支持的事件响应方式有 JavaScript 脚本、提交入库、发送邮件。如下图所示：
选择对应的事件响应方式添加即可，不同响应方式区别可参考：
事件响应方式
移动端无可配置项。
