跳到主要内容

DatePicker 日期选择 ​

WebH5

日期选择器。触发器风格与输入框一致,下拉日历面板支持年月切换、今天标记、min/max 限制;type=daterange 时双月并排选择日期范围,支持快捷选项;type=month/year 时为 4×3 月份/年份网格;type=datetime 时日期面板附时/分选择,确定后提交;移动端自动变为底部弹出,可用 mode 强制呈现方式。

何时使用 ​

需要用户选择某一天、一段日期范围、某月、某年或某个日期时间:预约、筛选日期、出差起止、报表周期、财年统计等。

何时不使用 ​

只需要时间(不带日期)时用 TimePicker;移动端原生日期输入更合适时用原生 input[type=date]。

Props ​

名称类型默认值说明
modelValuestring | [string, string] | null"null"绑定值:date 为 'YYYY-MM-DD',daterange 为 [开始, 结束] 元组,month 为 'YYYY-MM',year 为 'YYYY',datetime 为 'YYYY-MM-DD HH:mm',配合 v-model 使用
typestring:'date' | 'daterange' | 'month' | 'year' | 'datetime'"date"选择类型:date 单日 / daterange 日期范围 / month 月份 / year 年份 / datetime 日期时间
placeholderstring"undefined"占位文本(默认按 type 取语言包:date 用 datepicker.placeholder,month/year/datetime 用 monthPlaceholder/yearPlaceholder/datetimePlaceholder,daterange 用 startPlaceholder/endPlaceholder)
disabledbooleanfalse禁用
clearablebooleanfalse可清空(有值时 hover 显示清空按钮)
minstring"undefined"可选最小日期(含),格式 'YYYY-MM-DD',超出范围的日期禁用
maxstring"undefined"可选最大日期(含),格式 'YYYY-MM-DD',超出范围的日期禁用
minuteStepnumber30分钟步长(仅 datetime),决定分钟列的可选值
firstDayOfWeeknumber:'0' | '1'1每周起始日:0 周日 / 1 周一
modestring:'auto' | 'mobile' | 'desktop'"auto"弹层呈现方式:auto 跟随视口(≤767px 底部弹出)/ mobile 强制底部弹出 / desktop 强制下拉弹层
shortcuts{ label: string; value: [string, string] }[]"undefined"范围快捷选项(仅 daterange),面板左侧展示,点击直接选中并关闭

Events ​

名称载荷说明
update:modelValuestring | [string, string] | null选中或清空日期(范围)时触发
changestring | [string, string] | null选中或清空日期(范围)时触发
clearvoid点击清空按钮时触发

示例 ​

基础选择 ​

示例加载中…

可清空 ​

示例加载中…

限制可选范围 ​

示例加载中…

周日开头 ​

示例加载中…

禁用态 ​

示例加载中…

事件监听与表单联动 ​

示例加载中…

范围选择 ​

示例加载中…

范围快捷选项 ​

示例加载中…

月份选择 ​

示例加载中…

年份选择 ​

示例加载中…

日期时间选择 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 DatePicker 文档(含手机预览)。