YSS · 日期选择器（datepicker）

选择器： datepicker · 设计器组件： 日期选择器 · 按名称： datepicker#名称 或 #名称

形态为紧凑输入框 + 右侧箭头；点击展开月历弹层（对标下拉框 overlay）。内部规范存 YYYY-MM-DD，格式含时分秒时存 YYYY-MM-DD HH:mm:ss。弹层贴边时会自动上翻或夹入可视区，避免被窗口裁切。

专用属性

属性	说明	映射
color / background-color	输入区文字/背景	通用
border-* / border-radius / show-border	外框	边框属性
font-size 等	字体	字体
date / value / datetime	当前值	日期时间 / text
format	显示格式（可含 HH:mm:ss）	格式 / imagePath
placeholder	无值时占位文案	占位 / tooltip
editable	是否允许键盘输入	可编辑 / wordWrap
min-date / max-date	可选范围（空=不限）	最小 / 最大
show-week	弹层显示周次	周次 / allowCopy
show-lunar	弹层显示农历	农历 / textEllipsis
show-holiday	弹层显示节日	节日 / showHotkeyUnderline
year-start / year-end	年下拉起止年	起始年 / 结束年（paddingL/R）

万年历范围： 农历换算与年下拉有效区间为 1900–2100（起止年属性会被夹入此范围）。

弹层操作

• << / >>：上一年 / 下一年
• < / >：上一月 / 下一月
• 中间年标题：打开年份下拉
• 今：选中今天并关闭（含当前时分秒，若格式含时间）
• 含时间格式时另有时分秒调节与「确定」

示例

datepicker#日期选择器1 {
    color: #E0E0E0;
    background-color: #2D2D30;
    border-color: #5A5A5A;
    border-radius: 4;
    show-border: true;
    font-size: 13;
    format: yyyy-MM-dd HH:mm:ss;
    placeholder: 请选择日期时间;
    editable: true;
    show-week: true;
    show-lunar: true;
    show-holiday: true;
    year-start: 1990;
    year-end: 2035;
}

代码侧常用 API

日期选择器1.置日期("2026-09-04 18:30:00")
文本 d = 日期选择器1.取日期()
日期选择器1.当前日期 = "2026-09-04"
日期选择器1.打开面板()
日期选择器1.关闭面板()
日期选择器1.清空()

函数 日期选择器1.日期改变 (文本 日期) {
    输出(日期)
}

函数 日期选择器1.面板打开 () {
    输出("opened")
}

函数 日期选择器1.面板关闭 () {
    输出("closed")
}