# 变更记录
| **产品版本** | **更新内容** | **更新日期** |
| --- | --- | --- |
| V5.0.016 | 支持设置选项默认焦点时间点，如默认焦点到00:00:00或者当前时间 | 2023-03-09 |
# 1 功能介绍
用于选择时间的控件
# 2 控件对象
```
kd.bos.form.field.TimeEdit
```
# 3 视觉展示
默认
时分模式选择（掩码设置HH:mm）
# 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 等。在编辑过程中，会根据掩码进行格式化。
# 5 时间字段接口介绍
## 5.1 控件编程模型
时间字段的控件编程模型为TimeEdit类，派生自字段控件基类FieldEdit：
```java
package kd.bos.form.field;public class TimeEdit extends FieldEdit
```
在插件中，可以通过如下代码，获取时间字段编程模型：
```
/**
* 演示如果获取长日期字段的编程模型
*/
private void getFieldEdit(){
TimeEdit fieldEdit = this.getView().getControl(KEY_TIMEFIELD);
}
```
时间字段编程模型未提供FieldEdit以外的供插件使用的特别方法
## 5.2 数据模型
时间字段在运行时主实体模型中的属性对象为TimeProp类型
```java
package kd.bos.entity.property;public class TimeProp extends FieldProp {
```
DateTimeProp类型未提供FieldProp以外的供插件使用的特殊方法
时间字段的数据类型为bigInt类型，其数值为 时分秒对应凌晨（00:00:00）的秒数
如下实例代码，演示如何处理时间字段值：
```java
package kd.bos.debug.mservice; import kd.bos.form.plugin.AbstractFormPlugin; import java.util.EventObject;public class TimeFieldDemoPlugin extends AbstractFormPlugin {
/**
* 演示如何给时间字段赋值
*/
private void setFieldValueDemo(){
int s = 3*60*60 + 3*60 + 3; // -> 03:03:03
//单据头
this.getModel().setValue("timefield",s);
//单据体第1行
this.getModel().setValue("entry_timefield",s,0);
}
}
```
