# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V7.0.1 | 更新了日期字段属性，用户可通过"格式化"属性来设置日期选择面板的交互形态及选择完成后的显示格式 | 2024-10-24 |
# 1 功能介绍
用于选择日期的控件。结合 *字段布局面板 *控件使用，布局体验最佳。
# 2 控件对象
`kd.bos.form.field.DateEdit`
# 3 视觉展示
* 选择日期（默认态）
* 选择月份（格式化设置yyyy-MM）
* 选择年份（格式化设置yyyy）
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 | 支持版本 |
| --- | --- | --- | --- | --- |
| 格式化 | 下拉 | | 设置日期控件的交互形态及已选日期的显示格式，详情见4.3.1 | V7.0.1 |
| 掩码 | 下拉 | - | 设置日期控件的交互形态 | V7.0.1以后不再支持该属性，可使用格式化属性 |
| 格式化字符串 | 文本 | - | 设置日期控件编辑完成后的显示格式 | V7.0.1以后不再支持该属性，可使用格式化属性 |
| 缺省值 | 弹框选择 | - | 设置默认展示的日期 | |
| 可选范围 | 弹框选择 | - | 设置日期控件的可选范围，不能选择超出范围的日期 | |
| 为空提示信息 | 文本 | - | 当字段内容为空时，输入框内显示的信息 | |
| 加密存储 | 复选框 | false | 设置字段是否需要加密存储 | |
### 4.3.1 格式化
在V7.0.1版本后，将原来的“掩码”以及“格式化字符串“属性合并为“格式化”属性，用于设置日期控件的交互形态及已选日期的显示格式。
常见的掩码格式为: yyyy-MM, yyyy 等。
# 5 日期接口介绍
## 5.1 控件编程模型
### 5.1.1 控件编程模型定义
日期字段的控件编程模型是DateEdit，派生自长日期字段的控件编程模型DateTimeEdit：
```java
package kd.bos.form.field;
public class DateEdit extends DateTimeEdit implements ICloseCallBack {
```
### 5.1.2 控件方法清单
DateEdit重
