DatePicker 日期选择
WebH5
日期选择器。触发器风格与输入框一致,下拉日历面板支持年月切换、今天标记、min/max 限制;type=daterange 时双月并排选择日期范围,支持快捷选项;type=month/year 时为 4×3 月份/年份网格;type=datetime 时日期面板附时/分选择,确定后提交;移动端自动变为底部弹出,可用 mode 强制呈现方式。
何时使用
需要用户选择某一天、一段日期范围、某月、某年或某个日期时间:预约、筛选日期、出差起止、报表周期、财年统计等。
何时不使用
只需要时间(不带日期)时用 TimePicker;移动端原生日期输入更合适时用原生 input[type=date]。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | [string, string] | null | "null" | 绑定值:date 为 'YYYY-MM-DD',daterange 为 [开始, 结束] 元组,month 为 'YYYY-MM',year 为 'YYYY',datetime 为 'YYYY-MM-DD HH:mm',配合 v-model 使用 |
type | string:'date' | 'daterange' | 'month' | 'year' | 'datetime' | "date" | 选择类型:date 单日 / daterange 日期范围 / month 月份 / year 年份 / datetime 日期时间 |
placeholder | string | "undefined" | 占位文本(默认按 type 取语言包:date 用 datepicker.placeholder,month/year/datetime 用 monthPlaceholder/yearPlaceholder/datetimePlaceholder,daterange 用 startPlaceholder/endPlaceholder) |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空(有值时 hover 显示清空按钮) |
min | string | "undefined" | 可选最小日期(含),格式 'YYYY-MM-DD',超出范围的日期禁用 |
max | string | "undefined" | 可选最大日期(含),格式 'YYYY-MM-DD',超出范围的日期禁用 |
minuteStep | number | 30 | 分钟步长(仅 datetime),决定分钟列的可选值 |
firstDayOfWeek | number:'0' | '1' | 1 | 每周起始日:0 周日 / 1 周一 |
mode | string:'auto' | 'mobile' | 'desktop' | "auto" | 弹层呈现方式:auto 跟随视口(≤767px 底部弹出)/ mobile 强制底部弹出 / desktop 强制下拉弹层 |
shortcuts | { label: string; value: [string, string] }[] | "undefined" | 范围快捷选项(仅 daterange),面板左侧展示,点击直接选中并关闭 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | [string, string] | null | 选中或清空日期(范围)时触发 |
change | string | [string, string] | null | 选中或清空日期(范围)时触发 |
clear | void | 点击清空按钮时触发 |
示例
基础选择
示例加载中…
可清空
示例加载中…
限制可选范围
示例加载中…
周日开头
示例加载中…
禁用态
示例加载中…
事件监听与表单联动
示例加载中…
范围选择
示例加载中…
范围快捷选项
示例加载中…
月份选择
示例加载中…
年份选择
示例加载中…
日期时间选择
示例加载中…
Playground
加载中…
date
请选择
auto
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 DatePicker 文档(含手机预览)。