# 设置UI引擎前端页面日期选择组件属性
日期选择组件用于精准录入各类时间信息，支持日期、时间、周、月份、年份及时间范围的选择。本组件专门针对工业生产的计划排程、设备维护记录、工艺参数时间戳、生产批次追溯等场景进行优化，确保时间数据的一致性和准确性。
#### 前提条件
已在当前页面添加"日期选择"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"日期选择"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002503567328.png)，即可展开"属性"设置面板。
 
#### 基础信息
| 属性名称     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 是否支持变量绑定 |
|:---|:---|:---|
| 绑定值      | 存储从组件中选中的时间值，不同类型（如日期、日期范围）对应的值格式不同（单个Date对象/Date对象数组）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 是        |
| 类型       | 组件支持的时间选择类型，可选值： - 日期  - 日期时间  - 周  - 月份  - 年份  - 日期范围  - 日期时间范围   | 是        |
| 显示格式     | 用于格式化页面展示的日期文本，需使用指定的格式化占位符（请参见[表1]）。 示例：设置为"yyyy-MM-dd HH:mm:ss"，展示效果为"1970-01-01 00:00:00"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 是        |
| 日期值格式    | 指定"绑定值"的格式。 - 不指定时，绑定值为原生Date对象。  - 固定传入"timestamp"时，绑定值为时间戳格式。  - 其他情况参考"显示格式"的占位符格式（如"yyyy-MM-dd HH:mm:ss"）。                                                                                                                                                                                                                                                                                                                                                    | 是        |
| 占位文本     | 未选择日期时显示的提示文本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 是        |
| 开始日期占位文本 | "类型"为"日期范围/日期时间范围"时，开始日期输入框的提示文本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 是        |
| 结束日期占位文本 | "类型"为"日期范围/日期时间范围"时，结束日期输入框的提示文本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 是        |
| 清除按钮     | 是否启用一键清除功能。 开启后组件右侧显示清除按钮，单击可清空已选时间值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 是        |
| 禁用       | 是否禁用组件。 禁用后无法触发选择面板、输入或修改时间值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 是        |
| 只读       | 是否设置为只读模式。 只读状态下可展示已选时间，但无法修改（不能输入、不能触发选择面板）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 是        |
| 尺寸       | 组件整体大小。可选值："medium"、"small"、"mini"。 - mini：紧凑型仪表盘  - small：标准操作面板  - medium：报表/计划界面                                                                                                                                                                                                                                                                                                                                                                       | 是        |
| 文本框可输入   | 日期输入框是否允许手动输入时间。 禁用后仅能通过选择面板选择时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 是        |
| 取消面板联动   | "类型"为"日期范围/日期时间范围"时，是否取消左右面板联动。 启用后左右面板不再联动。例如，左侧面板和右侧面板可以选择不同的年月。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 是        |
   
 表1格式化占位符 
| 名称   | 说明                            |
|:---|:---|
| a    | 12小时制，显示am/pm（小写）。            |
| A    | 12小时制，显示AM/PM（大写）。            |
| d    | 日期（1-31），小于10时不补0（如1、9、10）。   |
| dd   | 日期（01-31），小于10时补0（如01、09、10）。 |
| h    | 小时（12小时制，1-12），小于10时不补0。      |
| hh   | 小时（12小时制，01-12），小于10时补0。      |
| H    | 小时（24小时制，0-23），小于10时不补0。      |
| HH   | 小时（24小时制，00-23），小于10时补0。      |
| m    | 分钟（0-59），小于10时不补0。            |
| mm   | 分钟（00-59），小于10时补0。            |
| M    | 月份（1-12），小于10时不补0。            |
| MM   | 月份（01-12），小于10时补0。            |
| s    | 秒（0-59），小于10时不补0。             |
| ss   | 秒（00-59），小于10时补0。             |
| W    | 周（1-53），小于10时不补0。             |
| WW   | 周（01-53），小于10时补0。             |
| yyyy | 完整年份（如2026）。                  |
   
#### 其他
如下属性适用于UI引擎所有组件，用于精细化控制。
| 属性名称   | 说明                                                                                                                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                         | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                 | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |
   
#### 组件事件
| 事件名称   | 类型定义                                   | 说明                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| blur   | ``` () => void ```                     | 当日期输入框失去焦点时触发。                                                                                                                                                                                                                                                                                                                                                                              |
| focus  | ``` () => void ```                     | 当日期输入框获得焦点时触发。                                                                                                                                                                                                                                                                                                                                                                              |
| change | ``` (value: Date | Date[]) => void ``` | 当用户确认选定的时间值时触发（如单击选择面板的"确定"按钮），参数为选中值： - 非范围类：单个Date对象。  - 范围类：Date对象数组（"\[开始时间, 结束时间\]"）。   |