配置	作用	相关示例
`format`	展示格式	禁用部分时间选项、时间上下限、纯面板确认与禁用选项
`disable-confirm`	跳过确认	跳过确认、纯面板确认与禁用选项
`use12-hours`	12 小时制	禁用部分时间选项
`step`	时分秒步长	定制步长
`hide-disabled-options`	隐藏禁用时间选项	纯面板确认与禁用选项

禁用回调中的小时始终为 0–23，与面板是否使用十二小时制无关：午夜为 0，中午为 12，下午 1 点为 13。切换 AM/PM 后会重新计算禁用选项。

定制步长

时间上下限

min / max 的类型为 string，默认不限制；格式固定为 24 小时制 HH:mm 或 HH:mm:ss，不受 format 或 use12Hours 影响，包含端点。HH:mm 的秒视为 00。范围的两个端点分别校验；showNextDay 不把边界变成跨午夜区间。min > max 时没有可提交时间。无法解析的边界按未设置处理。

动态修改边界不会改写外部模型。提交须同时满足边界、步长和禁用回调；不显示秒时按秒为 00 校验。列表粗粒度列在整个小时/分钟都越界时禁用，最终确认仍校验完整时间。隐藏禁用项使用 hide-disabled-options。

跳过确认

纯面板确认与禁用选项

纯面板默认确认后提交：选择时仅发 select，确认后才更新模型并发 change；disable-confirm 开启后有效选择立即提交。hide-disabled-options 默认 false，开启后隐藏禁用项；时钟保留原刻度角度。字段和日期组件内部显式跳过子面板确认，由外层负责提交。外部模型替换会重置草稿，不主动派发事件。

单值面板未确认草稿中打开只读、隐藏禁用小时或切立即提交，不会隐式提交旧草稿；解除只读也不提交，下一次有效选择才提交一次。Maple滚轮/时钟展示切换保留同一草稿，不回写父模型；鼠标/键盘验收不等于物理触屏惯性行为通过。

独立面板直接管理自己的草稿与提交状态。外部替换模型会重置草稿，不触发选择或变更事件；只读、禁用均阻止选择和确认。Cedar 使用列表，Maple 使用滚轮或时钟，展示层不另建一份草稿。

select(value, date)：修改草稿。
change(value, date)：有效确认且值变化时触发，并更新模型。
confirm(value, date)：每次有效确认均触发，包括值未变化；disableConfirm 模式在有效选择提交时也触发。禁用、只读或无效草稿不会触发。
extra：附加说明内容。
actions({ confirm, canConfirm, value })：替换默认操作栏；value 是草稿，调用 confirm() 提交，并根据 canConfirm 禁用按钮。

单时间事件值为格式化字符串及 Date；范围事件值为对应数组。纯面板不再派发 open-change、update:open 或 clear。

Props

参数	说明	类型	默认值
`model-value`	绑定值	`string \| number \| Date`	`-`
`format`	展示格式	`string`	`-`
`use12-hours`	12 小时制	`boolean`	`false`
`hide-disabled-options`	隐藏禁用时间选项	`boolean`	`false`
`disable-confirm`	跳过确认	`boolean`	`false`
`disabled`	禁用	`boolean`	`false`
`step`	时分秒步长	`object`	`-`

TimePicker

TimePicker

列表滚动任务审计（2026-10-16）

基础示例

基本用法

格式与展示

定制格式

本组配置对照

十二小时制

选择规则与交互

禁用部分时间选项