DatetimePicker 时间选择

引入

选择年月日

DatetimePicker 通过 type 属性来定义需要选择的时间类型，type 为 表示选择年月日。通过 min-date 和 max-date 属性可以确定可选的时间范围。

  1. <van-datetime-picker
  2.   v-model="currentDate"
  3.   type="date"
  4.   title="选择年月日"
  5.   :min-date="minDate"
  6.   :max-date="maxDate"
  7. />
  1. export default {
  2.   data() {
  3.     return {
  4.       minDate: new Date(2020, 0, 1),
  5.       maxDate: new Date(2025, 10, 1),
  6.       currentDate: new Date(),
  7.     };
  8.   },
  9. };

选择年月

将 type 设置为 year-month 即可选择年份和月份。通过传入 formatter 函数，可以对选项文字进行格式化处理。

  1. <van-datetime-picker
  2.   v-model="currentDate"
  3.   type="year-month"
  4.   title="选择年月"
  5.   :min-date="minDate"
  6.   :max-date="maxDate"
  7.   :formatter="formatter"
  8. />
  1. export default {
  2.   data() {
  3.     return {
  4.       minDate: new Date(2020, 0, 1),
  5.       maxDate: new Date(2025, 10, 1),
  6.       currentDate: new Date(),
  7.   },
  8.   methods: {
  9.     formatter(type, val) {
  10.       if (type === 'year') {
  11.         return `${val}年`;
  12.       } else if (type === 'month') {
  13.         return `${val}月`;
  14.       }
  15.       return val;
  16.     },
  17.   },
  18. };

选择月日

将 type 设置为 month-day 即可选择月份和日期（从 2.8.4 版本开始支持）。

  1. export default {
  2.   data() {
  3.     return {
  4.       minDate: new Date(2020, 0, 1),
  5.       maxDate: new Date(2025, 10, 1),
  6.       currentDate: new Date(),
  7.     };
  8.   },
  9.   methods: {
  10.     formatter(type, val) {
  11.       if (type === 'month') {
  12.         return `${val}月`;
  13.       } else if (type === 'day') {
  15.       }
  16.       return val;
  17.     },
  18.   },
  19. };

选择时间

将 type 设置为 time 即可选择时间（小时和分钟）。

  1. <van-datetime-picker
  2.   v-model="currentTime"
  3.   type="time"
  4.   title="选择时间"
  5.   :min-hour="10"
  6.   :max-hour="20"
  7. />
  1. export default {
  2.   data() {
  3.     return {
  4.       currentTime: '12:00',
  5.     };
  6.   },
  7. };

将 type 设置为 datetime 即可选择完整时间，包括年月日和小时、分钟。

  1. <van-datetime-picker
  2.   v-model="currentDate"
  3.   type="datetime"
  4.   title="选择完整时间"
  5.   :min-date="minDate"
  6.   :max-date="maxDate"
  7. />

选择年月日小时

  1.   v-model="currentDate"
  2.   type="datehour"
  3.   title="选择年月日小时"
  4.   :min-date="minDate"
  5.   :max-date="maxDate"
  6. />
  1. export default {
  2.   data() {
  3.     return {
  4.       minDate: new Date(2020, 0, 1),
  5.       maxDate: new Date(2025, 10, 1),
  6.       currentDate: new Date(),
  7.     };
  8.   },
  9. };

选项过滤器

通过传入 filter 函数，可以对选项数组进行过滤，实现自定义时间间隔。

  1. <van-datetime-picker v-model="currentTime" type="time" :filter="filter" />
  1. export default {
  2.   data() {
  3.     return {
  4.       currentTime: '12:00',
  5.     };
  6.   },
  7.   methods: {
  8.     filter(type, options) {
  9.       if (type === 'minute') {
  10.         return options.filter((option) => option % 5 === 0);
  11.       }
  12.       return options;
  14.   },
  15. };

自定义列排序

  1. export default {
  2.   data() {
  3.     return {
  4.       currentDate: new Date(),
  5.     };
  6.   },
  7.   methods: {
  8.     formatter(type, val) {
  9.       if (type === 'year') {
  10.         return val + '年';
  11.       }
  12.       if (type === 'month') {
  13.         return val + '月';
  14.       }
  15.       if (type === 'day') {
  16.         return val + '日';
  17.       }
  18.       return val;
  19.     },
  20.   },
  21. };

Props

DatePicker Props

当时间选择器类型为 date 或 datetime 时，支持以下 props:

当时间选择器类型为 time 时，支持以下 props:

Events

方法

通过 ref 可以获取到 DatetimePicker 实例并调用实例方法，详见组件实例方法

设置 min-date 或 max-date 后出现页面卡死的情况？

请注意不要在模板中直接使用类似min-date="new Date()"的写法，这样会导致每次渲染组件时传入一个新的 Date 对象，而传入新的数据会触发下一次渲染，从而陷入死循环。

在 iOS 系统上初始化组件失败？

如果你遇到了在 iOS 上无法渲染组件的问题，请确认在创建 Date 对象时没有使用这样的写法，iOS 不支持以中划线分隔的日期格式，正确写法是new Date('2020/01/01')。

对此问题的详细解释：。

在桌面端无法操作组件？

参见。

如果仅需要选择年份或者月份，建议直接使用 Picker 组件。