设置UI引擎前端页面日期选择组件属性

绑定值

存储从组件中选中的时间值，不同类型（如日期、日期范围）对应的值格式不同（单个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：报表/计划界面

是

文本框可输入

日期输入框是否允许手动输入时间。

禁用后仅能通过选择面板选择时间。

是

取消面板联动

“类型”为“日期范围/日期时间范围”时，是否取消左右面板联动。

启用后左右面板不再联动。例如，左侧面板和右侧面板可以选择不同的年月。

是

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）。

元素id值

对应HTML标签的“id”属性，同一页面内必须唯一。

是

样式类

对应HTML标签的“class”属性，为空格分隔的类名列表，用于自定义组件样式。默认为“component-base-style”。

是

ref引用类

对应Vue的“ref”属性，用于注册模板引用以访问组件实例方法。

如果为“数据源表单”组件，会自动填充默认值。

是

blur

() => void

当日期输入框失去焦点时触发。

focus

() => void

当日期输入框获得焦点时触发。

change

(value: Date | Date[]) => void

当用户确认选定的时间值时触发（如单击选择面板的“确定”按钮），参数为选中值：

• 非范围类：单个Date对象。
• 范围类：Date对象数组（“[开始时间, 结束时间]”）。