日期选择器 DatePicker

选择日期。支持月、周、日类型,也支持范围选择等

基本使用

日期选择器的基础使用

月份选择器

月份输入器的基础使用。设置typemonth即可

周选择器

周输入器的基础使用。设置 typeweek 即可

选择日期范围

你可以通过以下例子来学习如何设置一个日期范围选择器

选择月份范围

你当然还可以选择一个月的范围

双向绑定

通过 v-model 实现值的双向绑定。v-model绑定的值要根据type类型来定义。参考下面示例

不可选取的时间

使用 disabled-date 可以禁用某些日期

日期格式

1.使用 input-label-format 指定输入框显示时间的格式

type默认format
dateyyyy-MM-dd
daterangeyyyy-MM-dd
monthyyyy-MM
monthrangeyyyy-MM
weekyyyy-ww周

2.使用 model-value-format 指定绑定值的格式。默认情况下,组件接受并返回Date对象

WARNING

请一定要注意传入参数的大小写是否正确

3.format格式说明

格式输出描述
YY23两位数年份
YYYY2023四位数年份
M8一位数月份
MM08两位数月份
d1一位数日期
dd01二位数日期
h1-12一位数小时
hh01-12二位数小时
m0-59一位数分钟
mm00-59二位数分钟
s0-59一位数秒
ss00-59二位数秒
w0-53一位数周
ww00-53二位数周

每周的第一天开始于周几

使用 day-start-of-week 可以重置第一天开始于周几

自定义内容

弹出框的内容是可以自定义的,你可以使用 cell 插槽来获取到当前单元格的数据

DateCell

export interface DateCell {
  value: string | number
  label: string | number
  date: Date
  isNow: boolean
  isCur: boolean
  isPrev: boolean
  isNext: boolean
  isRange: boolean
  isSelect: boolean
  isRangeStart: boolean
  isRangeEnd: boolean
  isDisabled: boolean
  format: (date?: Date, formatter?: string) => string | undefined
}


API

Checkbox Attributes

属性名描述类型默认值
v-model双向绑定的值array | string | Date | numberdate
disabled是否禁用booleanfalse
placeholder提示文案string请选择
size尺寸大小small | default | largedefault
clearable是否可清空boolean-
range-separator输入框中日期展示的分隔符,一般只用于日期的范围选择string
day-start-of-week每周的第一天开始于周几,0:周日,1:周一,以此类推。0 | 1 | 2 | 3 | 4 | 5 | 61
model-value-format可选,绑定值的格式。 不指定则绑定值为 Date 对象string-
input-label-format显示在输入框中的格式,具体规则请看 这里string-
disabled-date不可选取的日期(date: Date) => boolean-
popup-class自定义弹出层类名string-
card输入框卡片模式 详情boolean-

Events

name描述函数类型
change选中值改变时触发(date: Date | Date[]) => void
show当下拉列表显示时触发-
hide当下拉列表隐藏时触发-

Slots

name描述scoped
cell自定义单元格内容{cell:DateCell}

最后更新时间: