For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/date-picker.md.
v0.0.57
  • 简体中文
  • DatePicker

    数据录入@rockshin/tao-ui

    输入或选择单个日期,并可选择时间。

    何时使用

    自由文本日期容易出错,或用户需要日历上下文时使用 DatePicker。

    推荐

    • 熟悉日期的用户应能直接键盘输入。
    • 常用相对日期可以提供预设。

    避免

    • 选择久远日期时,不要强迫用户只能逐月翻阅日历。

    代码演示

    基础用法

    TSX

    选择模式

    TSX

    时间、预设与禁用日期

    TSX

    日期与时间

    showTime 将日期和时间组合选择,格式应同时包含需要展示的部分。

    Value: 2026-11-16 12:42:22

    TSX

    常用日期预设

    用 presets 提供常见日期,减少重复打开日历和定位日期的操作。

    TSX

    限制可选日期

    disabledDate 按业务规则限制日期;本例使用本地日期计算。

    TSX

    尺寸与外观

    选择不同尺寸与 variant,匹配页面中的其他输入控件。

    TSX

    状态与禁用

    error 与 warning 表达校验状态,disabled 用于不可编辑的值。

    TSX

    切换语言

    通过 TaoProvider 的 locale 同步内置按钮、占位文字与日历标签。

    TSX

    限制日期范围

    minDate 与 maxDate 同时限制输入和日历导航,示例固定为 2026 年以便复现。

    TSX

    受控值与清空

    在 onChange 中保存值;清空后将值设为 null。

    No selection
    TSX

    自定义显示格式

    format 控制显示文本,值仍是 Dayjs;不要将显示格式误认为存储格式。

    TSX

    手机日期抽屉

    通过 mobile 在桌面也能试用抽屉,确认操作完成后提交选中日期。

    390 × 640
    TSX

    移动端抽屉标题按 mobileTitle → 最近的 Form.Item / FormField 的 label → 本地化默认文案取值。必填星号和帮助信息不会带入标题,placeholder 只用于输入提示。独立使用或搭配原生 HTML label 时,可显式设置 mobileTitle="出发日期"。

    移动端选择

    在手机预览中打开选择器,体验抽屉内的选择、确认和清空。

    390 × 640
    TSX

    API

    DatePicker

    属性说明类型默认值
    disabled是否禁用boolean | undefined-
    mobileTitleMobile drawer title. Defaults to the Form.Item/FormField label, then locale text.ReactNode-
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-