添加链接 注册    登录
link管理
链接快照平台
  • 输入网页链接，自动生成快照
  • 标签化管理网页链接
相关文章推荐
聪明伶俐的跑步鞋  ·  sfguide-using-snowflak ...·  3 周前    · 
温柔的豆浆  ·  An Experimental ...·  1 周前    · 
狂野的白开水  ·  Backup job completes ...·  1 周前    · 
好帅的冲锋衣  ·  pyspark--Window不同分组窗的使 ...·  4 天前    · 
英俊的红酒  ·  Spark窗口函数及应用 - 观远 BI ...·  4 天前    · 
温柔的打火机  ·  关于2023年3月全国计算机等级 ...·  1 月前    · 
老实的稀饭  ·  正在播放:日韩动漫甜点转生 ...·  2 月前    · 
睿智的大熊猫  ·  联想小新14摄像头画面闪烁原因 ...·  3 月前    · 
失眠的烤地瓜  ·  Libtorch报错：terminate ...·  3 月前    · 
踢足球的马铃薯  ·  Boost.MultiIndex ...·  3 月前    · 
link管理  ›  表单组件 - DatetimePicker 时间选择 - 《Vant 3.6 移动组件库文档(Vue 3版)》 - 书栈网 · BookStack
string date函数 datetimepicker date
https://www.bookstack.cn/read/vant-3.6.4-zh/43046d46fb4ac404.md
踢足球的鼠标
1 年前

DatetimePicker 时间选择

介绍

时间选择器，支持日期、年月、时分等维度，通常与 弹出层 组件配合使用。

引入

通过以下方式来全局注册组件，更多注册方式请参考 组件注册 。 

  1. import { createApp } from 'vue';
  2. import { DatetimePicker } from 'vant';
  4. const app = createApp();
  5. app.use(DatetimePicker);

代码演示

选择年月日

DatetimePicker 通过 type 属性来定义需要选择的时间类型，type 为 date 表示选择年月日。通过 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. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentDate = ref(new Date(2021, 0, 17));
  6.     return {
  7.       minDate: new Date(2020, 0, 1),
  8.       maxDate: new Date(2025, 10, 1),
  9.       currentDate,
  10.     };
  11.   },
  12. };

选择年月

将 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. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentDate = ref(new Date());
  7.     const formatter = (type, val) => {
  8.       if (type === 'year') {
  9.         return `${val}年`;
  10.       }
  11.       if (type === 'month') {
  12.         return `${val}月`;
  13.       }
  14.       return val;
  15.     };
  17.     return {
  18.       minDate: new Date(2020, 0, 1),
  19.       maxDate: new Date(2025, 10, 1),
  20.       formatter,
  21.       currentDate,
  22.     };
  23.   },
  24. };

选择月日

将 type 设置为 month-day 即可选择月份和日期。 

  1. <van-datetime-picker
  2.   v-model="currentDate"
  3.   type="month-day"
  4.   title="选择月日"
  5.   :min-date="minDate"
  6.   :max-date="maxDate"
  7.   :formatter="formatter"
  8. />
  1. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentDate = ref(new Date());
  7.     const formatter = (type, val) => {
  8.       if (type === 'month') {
  9.         return `${val}月`;
  10.       }
  11.       if (type === 'day') {
  12.         return `${val}日`;
  13.       }
  14.       return val;
  15.     };
  17.     return {
  18.       minDate: new Date(2020, 0, 1),
  19.       maxDate: new Date(2025, 10, 1),
  20.       formatter,
  21.       currentDate,
  22.     };
  23.   },
  24. };

选择时间

将 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. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentTime = ref('12:00');
  6.     return { currentTime };
  7.   },
  8. };

选择完整时间

将 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. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentDate = ref(new Date());
  6.     return {
  7.       minDate: new Date(2020, 0, 1),
  8.       maxDate: new Date(2025, 10, 1),
  9.       currentDate,
  10.     };
  11.   },
  12. };

选择年月日小时

将 type 设置为 datehour 即可选择日期和小时，包括年月日和小时。 

  1. <van-datetime-picker
  2.   v-model="currentDate"
  3.   type="datehour"
  4.   title="选择年月日小时"
  5.   :min-date="minDate"
  6.   :max-date="maxDate"
  7. />
  1. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentDate = ref(new Date());
  6.     return {
  7.       minDate: new Date(2020, 0, 1),
  8.       maxDate: new Date(2025, 10, 1),
  9.       currentDate,
  10.     };
  11.   },
  12. };

选项过滤器

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

  1. <van-datetime-picker v-model="currentTime" type="time" :filter="filter" />
  1. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentTime = ref('12:00');
  7.     const filter = (type, options) => {
  8.       if (type === 'minute') {
  9.         return options.filter((option) => Number(option) % 5 === 0);
  10.       }
  11.       return options;
  12.     };
  14.     return {
  15.       filter,
  16.       currentTime,
  17.     };
  18.   },
  19. };

自定义列排序 

  1. <van-datetime-picker
  2.   v-model="currentDate"
  3.   type="date"
  4.   title="自定义列排序"
  5.   :columns-order="['month', 'day', 'year']"
  6.   :formatter="formatter"
  7. />
  1. import { ref } from 'vue';
  3. export default {
  4.   setup() {
  5.     const currentDate = ref(new Date());
  7.     const formatter = (type, val) => {
  8.       if (type === 'year') {
  9.         return val + '年';
  10.       }
  11.       if (type === 'month') {
  12.         return val + '月';
  13.       }
  14.       if (type === 'day') {
  15.         return val + '日';
  16.       }
  17.       return val;
  18.     };
  20.     return {
  21.       formatter,
  22.       currentDate,
  23.     };
  24.   },
  25. };

API

Props

参数 说明 类型 默认值
type 时间类型，可选值为 date time
year-month month-day datehour 		string datetime
title 顶部栏标题 string ‘’
confirm-button-text 确认按钮文字 string 确认
cancel-button-text 取消按钮文字 string 取消
show-toolbar 是否显示顶部栏 boolean true
loading 是否显示加载状态 boolean false
readonly 是否为只读状态，只读状态下无法切换选项 boolean false
filter 选项过滤函数 (type: string, values: string[]) => string[] -
formatter 选项格式化函数 (type: string, value: string) => string -
columns-order 自定义列排序数组, 子项可选值为
year 、 month 、 day 、 hour 、 minute 		string[] -
item-height 选项高度，支持 px vw vh rem 单位，默认 px number | string 44
visible-item-count 可见的选项个数 number | string 6
swipe-duration 快速滑动时惯性滚动的时长，单位 ms number | string 1000

DatePicker Props

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

参数 说明 类型 默认值
min-date 可选的最小时间，精确到分钟 Date 十年前
max-date 可选的最大时间，精确到分钟 Date 十年后

TimePicker Props

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

参数 说明 类型 默认值
min-hour 可选的最小小时 number | string 0
max-hour 可选的最大小时 number | string 23
min-minute 可选的最小分钟 number | string 0
max-minute 可选的最大分钟 number | string 59

Events

事件名 说明 回调参数
change 当值变化时触发的事件 value: 当前选中的时间
confirm 点击完成按钮时触发的事件 value: 当前选中的时间
cancel 点击取消按钮时触发的事件 -

Slots

名称 说明 参数
default 自定义整个顶部栏的内容 -
title 自定义标题内容 -
confirm 自定义确认按钮内容 -
cancel 自定义取消按钮内容 -
option 自定义选项内容 option: string | object
columns-top 自定义选项上方内容 -
columns-bottom 自定义选项下方内容 -

方法

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

方法名 说明 参数 返回值
getPicker 获取 Picker 实例，用于调用 Picker 的 实例方法 - -

类型定义

组件导出以下类型定义： 

  1. import type {
  2.   DatetimePickerType,
  3.   DatetimePickerProps,
  4.   DatetimePickerInstance,
  5. } from 'vant';

DatetimePickerInstance 是组件实例的类型，用法如下： 

  1. import { ref } from 'vue';
  2. import type { DatetimePickerInstance } from 'vant';
  4. const datetimePickerRef = ref<DatetimePickerInstance>();
  6. datetimePickerRef.value?.getPicker();

常见问题

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

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

正确的做法是将 min-date 作为一个数据定义在 data 函数中。

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

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

对此问题的详细解释： stackoverflow 。

在桌面端无法操作组件？

参见 桌面端适配 。

是否有年份或月份选择器？

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

你也可以升级到 Vant 4，并使用 DatePicker 日期选择 组件。

是否支持选择秒？

Vant 3 中的 DatetimePicker 组件不支持选择秒。

请升级到 Vant 4，并使用 TimePicker 时间选择 组件。

 
推荐文章
聪明伶俐的跑步鞋  ·  sfguide-using-snowflake-cortex-and-streamlit-with-geospatial-data/sis001.py at main · Snowflake-Labs
3 周前
温柔的豆浆  ·  An Experimental Investigation of Text-based CAPTCHA Attacks and Their Robustness | ACM Computing Sur
1 周前
狂野的白开水  ·  Backup job completes with: errno = 62 - Timer expired status: 41: network connection timed out
1 周前
好帅的冲锋衣  ·  pyspark--Window不同分组窗的使用_window.partitionby
4 天前
英俊的红酒  ·  Spark窗口函数及应用 - 观远 BI - 观远数据帮助中心
4 天前
温柔的打火机  ·  关于2023年3月全国计算机等级 考试报名工作的通知-数学统计学院
1 月前
老实的稀饭  ·  正在播放:日韩动漫甜点转生 最强甜点师降临异世界 第2集-魔都动漫
2 月前
睿智的大熊猫  ·  联想小新14摄像头画面闪烁原因 联想小新14摄像头一直闪解决方法
3 月前
失眠的烤地瓜  ·  Libtorch报错：terminate called after throwing an instance of ‘c10::Error‘ what():isTensor()INTERNAL ASS
3 月前
踢足球的马铃薯  ·  Boost.MultiIndex Documentation - Tutorial - Index types - 1.86.0
3 月前
Link管理   ·   51好读   ·   Sov5搜索   ·   小百科
link管理 - 链接快照平台