# 1 功能介绍
用于选择时间的控件。结合 *字段布局面板 *控件使用，布局体验最佳。
# 2 控件对象
`kd.bos.form.field.TimeEdit`
# 3 视觉展示
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 掩码 | 下拉 | - | 设置日期控件的交互形态，详情见4.3.1 |
| 为空提示信息 | 文本 | - | 当字段内容为空时，输入框内显示的信息 |
### 4.3.1 掩码
用于设置时间控件的交互形态，常见的掩码格式为: HH:mm:ss，HH:mm，HH 等。
# 5 时间字段接口介绍
## 5.1 控件编程模型
时间字段的控件编程模型是TimeEdit，派生自字段基类的控件编程模型FieldEdit：
```java
package kd.bos.form.field;
public class TimeEdit extends FieldEdit
```
在插件中，可以通过如下代码，获取时间字段编程模型：
```java
/**
* 演示如何获取长日期字段的编程模型
*/
private void getFieldEdit(){
TimeEdit fieldEdit = this.getView().getControl(KEY_TIMEFIELD);
}
```
时间字段编程模型未提供除FieldEdit以外的供插件使用的方法
## 5.2 数据模型
时间字段在运行时，主实体模型中的属性对象类型为TimeProp：
```java
package kd.bos.entity.p
