Vue3日期選擇器DatePicker實(shí)例詳解
更新時(shí)間：2025年07月03日 10:47:10 作者：theMuseCatcher
本文介紹了一個(gè)基于@vuepic/vue-datepicker的Vue3日期選擇器組件,支持多種日期選擇模式,并提供豐富的自定義選項(xiàng),本文結(jié)合實(shí)例代碼給大家介紹的非常詳細(xì),感興趣的朋友一起看看吧
本組件基于 @vuepic/vue-datepicker@11.0.2 進(jìn)行二次封裝，以便更適合日常使用！
官方文檔：https://vue3datepicker.com/installation/
除了范圍選擇器、年選擇器以外，其余選擇的日期（v-model）均默認(rèn)返回字符串指定格式日期！
可自定義設(shè)置以下二次封裝屬性（也可根據(jù)官方文檔設(shè)定相應(yīng)屬性，組件已設(shè)置繼承所有屬性）：
日期選擇器寬度（width），類(lèi)型：string | number，單位 px，默認(rèn) 150
日期選擇器大?。╯ize），類(lèi)型：'small' | 'middle' | 'large'，默認(rèn) 'middle'
選擇器模式（mode），類(lèi)型：'time' | 'date' | 'week' | 'month' | 'year'，默認(rèn) 'date'
日期展示格式（format），類(lèi)型：string | ((date: Date) => string) | ((dates: Date[]) => string)，默認(rèn) DefaultFormat
是否增加時(shí)間選擇（showTime），類(lèi)型：boolean，默認(rèn) false
是否展示”今天“按鈕（showToday），類(lèi)型：boolean，默認(rèn) false
是否使用范圍選擇器（range），類(lèi)型：boolean，默認(rèn) false
范圍選擇器最長(zhǎng)日期可選擇范圍（maxRange），單位天，類(lèi)型：number，默認(rèn) undefined；僅當(dāng) range: true 時(shí)生效
v-model 值的類(lèi)型（modelType），類(lèi)型：'timestamp' | 'format'，默認(rèn) 'format'，可選 timestamp：時(shí)間戳、format：字符串，mode 為 week 或 year 時(shí)，該配置不生效
雙向綁定值（v-model:modelValue），類(lèi)型：number | string | object | array，默認(rèn) null
更多使用方式還請(qǐng)查閱官方文檔，功能設(shè)計(jì)非常全面，各部分主題顏色也均可自定義修改！
常用官方屬性舉例：
日期展示格式（format），類(lèi)型：string | ((date: Date) => string) | ((dates: Date[]) => string)，默認(rèn) DefaultFormat
format 支持的格式化占位符為：
yy: 年, M: 月, d: 天, H: 時(shí), m: 分, s: 秒, w: 周
其中 DefaultFormat 取值如下：
范圍選擇器是否使用雙日期面板（multiCalendars），類(lèi)型：boolean，默認(rèn) false
定義選擇順序（flow），類(lèi)型：array，默認(rèn) []，可選 ("calendar" | "time" | "month" | "year" | "minutes" | "hours" | "seconds")[]
樣式主題是否使用黑色（dark），類(lèi)型：boolean，默認(rèn) false
是否展示秒選擇（enable-seconds），類(lèi)型：boolean，默認(rèn) false
效果如下圖：
在線預(yù)覽
①創(chuàng)建日期選擇器組件DatePicker.vue：
其中引入使用了以下工具函數(shù)：
<script setup lang="ts">
import VueDatePicker from '@vuepic/vue-datepicker'
import '@vuepic/vue-datepicker/dist/main.css'
import { computed, ref, watch } from 'vue'
import { useInject } from 'components/utils'
export interface Props {
width?: string | number // 日期選擇器寬度，單位 px
size?: 'small' | 'middle' | 'large' // 日期選擇器大小
mode?: 'time' | 'date' | 'week' | 'month' | 'year' // 選擇器模式，可選：時(shí)間 time，日期 date，周 week，月 month，年 year
// format?: string | ((date: Date) => string) | ((dates: Date[]) => string) // 日期展示格式，(yy: 年, M: 月, d: 天, H: 時(shí), m: 分, s: 秒, w: 周)
showTime?: boolean // 是否增加時(shí)間選擇
showToday?: boolean // 是否展示”今天“按鈕
range?: boolean // 是否使用范圍選擇器
maxRange?: number // 范圍選擇器最長(zhǎng)日期可選擇范圍，單位天，僅當(dāng) range: true 時(shí)生效
// multiCalendars?: boolean // 范圍選擇器是否使用雙日期面板
// flow?: any[] // 定義選擇順序 ("calendar" | "time" | "month" | "year" | "minutes" | "hours" | "seconds")[]
// dark?: boolean // 樣式主題是否使用黑色
modelType?: 'timestamp' | 'format' // v-model 值類(lèi)型，可選 timestamp: 時(shí)間戳、format: 字符串，mode 為 week 或 year 時(shí)，該配置不生效
}
const props = withDefaults(defineProps<Props>(), {
width: 150,
size: 'middle',
mode: 'date',
/* format default
Single picker: 'MM/dd/yyyy HH:mm'
Range picker: 'MM/dd/yyyy HH:mm - MM/dd/yyyy HH:mm'
Month picker: 'MM/yyyy'
Time picker: 'HH:mm'
Time picker range: 'HH:mm - HH:mm'
Week picker: 'ww-yyyy'
*/
showTime: false,
showToday: false,
range: false,
maxRange: undefined,
// multiCalendars: false,
// flow: () => [],
// dark: false,
modelType: 'format'
})
const { colorPalettes, shadowColor } = useInject('DatePicker') // 主題色注入
const datepickerWidth = computed(() => {
if (typeof props.width === 'number') {
return `${props.width}px`
}
return props.width
})
const time = computed(() => {
return props.mode === 'time'
})
const week = computed(() => {
return props.mode === 'week'
})
const month = computed(() => {
return props.mode === 'month'
})
const year = computed(() => {
return props.mode === 'year'
})
// const format = (date: Date) => {
// const day = date.getDate()
// const month = date.getMonth() + 1
// const year = date.getFullYear()
// return `${year}-${month}-${day}`
// }
const startTs = ref<number | null>(null) // 范圍選擇器的開(kāi)始時(shí)間戳
const rangeTs = computed(() => {
return (props.maxRange ?? 0) * 24 * 60 * 60 * 1000
})
watch(
() => props.maxRange,
() => {
startTs.value = null
}
)
function onClosed() {
startTs.value = null
}
function rangeStart(date: Date) {
startTs.value = date.getTime()
}
function maxRangeDisabledDates(date: Date): boolean {
const current = date.getTime()
if (startTs.value && Math.abs(current - startTs.value) >= rangeTs.value) return true
return false
}
</script>
<template>
<VueDatePicker
class="m-datepicker"
:class="{
'datepicker-small': size === 'small',
'datepicker-large': size === 'large'
}"
:style="`
--datepicker-width: ${datepickerWidth};
--datepicker-primary-color: ${colorPalettes[5]};
--datepicker-primary-color-hover: ${colorPalettes[4]};
--datepicker-primary-color-focus: ${colorPalettes[4]};
--datepicker-primary-shadow-color: ${shadowColor};
`"
locale="zh-CN"
position="left"
:month-change-on-scroll="false"
:enable-time-picker="showTime"
:time-picker="time"
:week-picker="week"
:month-picker="month"
:year-picker="year"
:range="range"
now-button-label="今天"
:show-now-button="showToday"
auto-apply
text-input
:model-type="modelType"
:day-names="['一', '二', '三', '四', '五', '六', '七']"
:disabled-dates="range && maxRange ? maxRangeDisabledDates : []"
@range-start="rangeStart"
@closed="onClosed"
/>
</template>
<style lang="less" scoped>
.m-datepicker {
display: inline-block;
width: var(--datepicker-width);
:deep(.dp__input_wrap) {
svg {
fill: currentColor;
}
.dp__input {
line-height: 1.5714285714285714;
}
:deep(.dp__input:hover:not(.dp__disabled)) {
border-color: var(--dp-border-color-hover);
}
.dp__disabled {
color: rgba(0, 0, 0, 0.25);
cursor: not-allowed;
&:hover {
border-color: var(--dp-border-color);
}
}
.dp__input_focus {
box-shadow: 0 0 0 2px var(--datepicker-primary-shadow-color);
}
}
:deep(.dp__outer_menu_wrap) {
.dp__menu {
overflow: hidden;
border: none;
border-radius: 8px;
box-shadow:
0 6px 16px 0 rgba(0, 0, 0, 0.08),
0 3px 6px -4px rgba(0, 0, 0, 0.12),
0 9px 28px 8px rgba(0, 0, 0, 0.05);
.dp__arrow_top,
.dp__arrow_bottom {
display: none;
}
.dp__overlay {
padding-top: 8px;
.dp__overlay_container::-webkit-scrollbar-thumb {
border-radius: 5px;
cursor: pointer;
background-color: var(--dp-scroll-bar-color);
transition: background-color 0.2s cubic-bezier(0.4, 0, 0.2, 1);
&:hover {
background-color: rgba(0, 0, 0, 0.4);
}
}
}
.dp__cell_offset.dp__range_start {
color: var(--dp-primary-text-color);
}
.dp__cell_disabled.dp__date_hover {
&:hover {
background: transparent;
color: var(--dp-secondary-color);
}
}
.dp__cell_disabled.dp__today {
background: transparent;
border: 1px solid var(--dp-secondary-color);
}
.dp__cell_disabled.dp__active_date {
color: rgba(0, 0, 0, 0.45);
border-color: var(--dp-secondary-color);
}
.dp__range_between {
&:not(.dp__today) {
border-color: transparent;
}
&.dp__cell_disabled {
background: transparent;
color: var(--dp-secondary-color);
}
}
}
}
}
// CSS variables
.m-datepicker {
/*General*/
--dp-font-family:
-apple-system, blinkmacsystemfont, 'Segoe UI', roboto, oxygen, ubuntu, cantarell, 'Open Sans', 'Helvetica Neue',
sans-serif;
--dp-border-radius: 6px; /*Configurable border-radius*/
--dp-cell-border-radius: 4px; /*Specific border radius for the calendar cell*/
// --dp-common-transition: all 0.1s ease-in; /*Generic transition applied on buttons and calendar cells*/
--dp-common-transition: all 0.2s ease; /*Generic transition applied on buttons and calendar cells*/
/*Sizing*/
--dp-button-height: 35px; /*Size for buttons in overlays*/
--dp-month-year-row-height: 35px; /*Height of the month-year select row*/
--dp-month-year-row-button-size: 35px; /*Specific height for the next/previous buttons*/
--dp-button-icon-height: 20px; /*Icon sizing in buttons*/
--dp-cell-size: 35px; /*Width and height of calendar cell*/
--dp-cell-padding: 5px; /*Padding in the cell*/
--dp-common-padding: 10px; /*Common padding used*/
--dp-input-icon-padding: 35px; /*Padding on the left side of the input if icon is present*/
--dp-input-padding: 4px 30px 4px 12px; /*Padding in the input*/
--dp-menu-min-width: 260px; /*Adjust the min width of the menu*/
--dp-action-buttons-padding: 2px 5px; /*Adjust padding for the action buttons in action row*/
--dp-row-margin: 5px 0; /*Adjust the spacing between rows in the calendar*/
--dp-calendar-header-cell-padding: 0.5rem; /*Adjust padding in calendar header cells*/
--dp-two-calendars-spacing: 10px; /*Space between multiple calendars*/
--dp-overlay-col-padding: 3px; /*Padding in the overlay column*/
--dp-time-inc-dec-button-size: 32px; /*Sizing for arrow buttons in the time picker*/
--dp-menu-padding: 6px 8px; /*Menu padding*/
/*Font sizes*/
--dp-font-size: 14px; /*Default font-size*/
--dp-preview-font-size: 12px; /*Font size of the date preview in the action row*/
--dp-time-font-size: 28px; /*Font size in the time picker*/
/*Transitions*/
--dp-animation-duration: 0.2s; /*Transition duration*/
--dp-menu-appear-transition-timing: cubic-bezier(0.4, 0, 0.2, 1); /*Timing on menu appear animation*/
--dp-transition-timing: ease-in-out; /*Timing on slide animations*/
// 向下彈出時(shí)的過(guò)渡效果
.slide-down-enter {
transform: scale(0);
transform-origin: 0% 0%;
opacity: 0;
animation-timing-function: cubic-bezier(0.23, 1, 0.32, 1);
animation-duration: 0.2s;
animation-fill-mode: both;
animation-play-state: paused;
}
.slide-down-enter-active {
animation-name: slideDownIn;
animation-play-state: running;
@keyframes slideDownIn {
0% {
transform: scaleY(0.8);
transform-origin: 0% 0%;
opacity: 0;
}
100% {
transform: scaleY(1);
transform-origin: 0% 0%;
opacity: 1;
}
}
}
.slide-down-leave {
animation-timing-function: cubic-bezier(0.755, 0.05, 0.855, 0.06);
animation-duration: 0.2s;
animation-fill-mode: both;
animation-play-state: paused;
}
.slide-down-leave-active {
animation-name: slideDownOut;
animation-play-state: running;
@keyframes slideDownOut {
0% {
transform: scaleY(1);
transform-origin: 0% 0%;
opacity: 1;
}
100% {
transform: scaleY(0.8);
transform-origin: 0% 0%;
opacity: 0;
}
}
}
:deep(.dp-menu-appear-bottom-enter-active, .dp-slide-down-enter-active) {
.slide-down-enter();
}
:deep(.dp-menu-appear-bottom-leave-active, .dp-slide-down-leave-active) {
.slide-down-leave();
.slide-down-leave-active();
}
:deep(.dp-menu-appear-bottom-enter-from, .dp-slide-down-enter-from) {
.slide-down-enter();
}
:deep(.dp-menu-appear-bottom-enter-to, .dp-slide-down-enter-to) {
.slide-down-enter();
.slide-down-enter-active();
}
:deep(.dp-menu-appear-bottom-leave-from, .dp-slide-down-leave-from) {
.slide-down-leave();
}
:deep(.dp-menu-appear-bottom-leave-to, .dp-slide-down-leave-to) {
.slide-down-leave();
.slide-down-leave-active();
}
// 向上彈出時(shí)的過(guò)渡效果
.slide-up-enter {
transform: scale(0);
transform-origin: bottom left;
opacity: 0;
animation-timing-function: cubic-bezier(0.23, 1, 0.32, 1);
animation-duration: 0.2s;
animation-fill-mode: both;
animation-play-state: paused;
}
.slide-up-enter-active {
animation-name: slideUpIn;
animation-play-state: running;
@keyframes slideUpIn {
0% {
transform: scaleY(0.8);
transform-origin: bottom left;
opacity: 0;
}
100% {
transform: scaleY(1);
transform-origin: bottom left;
opacity: 1;
}
}
}
.slide-up-leave {
animation-timing-function: cubic-bezier(0.755, 0.05, 0.855, 0.06);
animation-duration: 0.2s;
animation-fill-mode: both;
animation-play-state: paused;
}
.slide-up-leave-active {
animation-name: slideUpOut;
animation-play-state: running;
@keyframes slideUpOut {
0% {
transform: scaleY(1);
transform-origin: bottom left;
opacity: 1;
}
100% {
transform: scaleY(0.8);
transform-origin: bottom left;
opacity: 0;
}
}
}
:deep(.dp-menu-appear-top-enter-active, .dp-slide-up-enter-active) {
.slide-up-enter();
}
:deep(.dp-menu-appear-top-leave-active, .dp-slide-up-leave-active) {
.slide-up-leave();
.slide-up-leave-active();
}
:deep(.dp-menu-appear-top-enter-from, .dp-slide-up-enter-from) {
.slide-up-enter();
}
:deep(.dp-menu-appear-top-enter-to, .dp-slide-up-enter-to) {
.slide-up-enter();
.slide-up-enter-active();
}
:deep(.dp-menu-appear-top-leave-from, .dp-slide-up-leave-from) {
.slide-up-leave();
}
:deep(.dp-menu-appear-top-leave-to, .dp-slide-up-leave-to) {
.slide-up-leave();
.slide-up-leave-active();
}
}
.datepicker-small {
--dp-input-padding: 0px 30px 0px 12px;
}
.datepicker-large {
--dp-font-size: 16px;
:deep(.dp__input_wrap) {
.dp__input {
height: 40px;
}
}
}
// dark theme configuration
.dp__theme_dark,
:deep(.dp__theme_dark) {
--dp-background-color: #212121;
--dp-text-color: #fff;
--dp-hover-color: #484848;
--dp-hover-text-color: #fff;
--dp-hover-icon-color: #959595;
// --dp-primary-color: #005cb2;
--dp-primary-color: #1668dc;
--dp-primary-disabled-color: #61a8ea;
--dp-primary-text-color: #fff;
--dp-secondary-color: #a9a9a9;
--dp-border-color: #2d2d2d;
--dp-menu-border-color: #2d2d2d;
--dp-border-color-hover: #aaaeb7;
--dp-border-color-focus: #aaaeb7;
--dp-disabled-color: #737373;
--dp-disabled-color-text: #d0d0d0;
--dp-scroll-bar-background: #212121;
--dp-scroll-bar-color: #484848;
--dp-success-color: #00701a;
--dp-success-color-disabled: #428f59;
--dp-icon-color: #959595;
--dp-danger-color: #e53935;
--dp-marker-color: #e53935;
--dp-tooltip-color: #3e3e3e;
--dp-highlight-color: rgb(0 92 178 / 20%);
--dp-range-between-dates-background-color: var(--dp-hover-color, #484848);
--dp-range-between-dates-text-color: var(--dp-hover-text-color, #fff);
--dp-range-between-border-color: var(--dp-hover-color, #fff);
}
// light theme configuration
.dp__theme_light,
:deep(.dp__theme_light) {
--dp-background-color: #fff;
// --dp-text-color: #212121;
--dp-text-color: rgba(0, 0, 0, 0.88);
// --dp-hover-color: #f3f3f3;
--dp-hover-color: rgba(0, 0, 0, 0.04);
// --dp-hover-text-color: #212121;
--dp-hover-text-color: rgba(0, 0, 0, 0.88);
--dp-hover-icon-color: #959595;
// --dp-primary-color: #1976d2;
--dp-primary-color: var(--datepicker-primary-color);
--dp-primary-disabled-color: #6bacea;
// --dp-primary-text-color: #f8f5f5;
--dp-primary-text-color: #fff;
// --dp-secondary-color: #c0c4cc;
--dp-secondary-color: rgba(0, 0, 0, 0.25);
// --dp-border-color: #ddd;
--dp-border-color: #d9d9d9;
// --dp-menu-border-color: #ddd;
--dp-menu-border-color: #d9d9d9;
// --dp-border-color-hover: #aaaeb7;
--dp-border-color-hover: var(--datepicker-primary-color-hover);
// --dp-border-color-focus: #aaaeb7;
--dp-border-color-focus: var(--datepicker-primary-color-focus);
// --dp-disabled-color: #f6f6f6;
--dp-disabled-color: rgba(0, 0, 0, 0.04);
// --dp-scroll-bar-background: #f3f3f3;
--dp-scroll-bar-background: transparent;
// --dp-scroll-bar-color: #959595;
--dp-scroll-bar-color: rgba(0, 0, 0, 0.25);
--dp-success-color: #76d275;
--dp-success-color-disabled: #a3d9b1;
--dp-icon-color: #959595;
--dp-danger-color: #ff6f60;
--dp-marker-color: #ff6f60;
--dp-tooltip-color: #fafafa;
--dp-disabled-color-text: #8e8e8e;
--dp-highlight-color: rgb(25 118 210 / 10%);
// --dp-range-between-dates-background-color: var(--dp-hover-color, #f3f3f3);
--dp-range-between-dates-background-color: rgba(0, 0, 0, 0.04);
// --dp-range-between-dates-text-color: var(--dp-hover-text-color, #212121);
--dp-range-between-dates-text-color: rgba(0, 0, 0, 0.88);
// --dp-range-between-border-color: var(--dp-hover-color, #f3f3f3);
--dp-range-between-border-color: rgba(0, 0, 0, 0.04);
}
</style>②在要使用的頁(yè)面引入：
其中引入使用了以下組件：
<script setup lang="ts">
import DatePicker from './DatePicker.vue'
import pkg from '/package.json'
import { ref, watchEffect, computed } from 'vue'
import {
format,
endOfDay,
endOfMonth,
endOfYear,
startOfMonth,
startOfYear,
subMonths,
addDays,
startOfWeek,
endOfWeek,
addHours,
addMinutes,
addSeconds,
getMonth,
addMonths
} from 'date-fns'
const dateValue = ref(format(new Date(), 'yyyy-MM-dd'))
const dateTimeValue = ref(format(new Date(), 'yyyy-MM-dd HH:mm:ss'))
const rangeValue = ref<string[]>([format(new Date(), 'yyyy-MM-dd'), format(addDays(new Date(), 3), 'yyyy-MM-dd')])
const rangeTimeValue = ref<string[]>([
format(new Date(), 'yyyy-MM-dd HH:mm:ss'),
format(addDays(new Date(), 3), 'yyyy-MM-dd HH:mm:ss')
])
const maxRangeValue = ref<string[]>([format(new Date(), 'yyyy-MM-dd'), format(addDays(new Date(), 6), 'yyyy-MM-dd')])
const timeRangeValue = ref([
{
hours: new Date().getHours(),
minutes: new Date().getMinutes(),
seconds: new Date().getSeconds()
},
{
hours: addHours(Date.now(), 1).getHours(),
minutes: addMinutes(Date.now(), 10).getMinutes(),
seconds: addSeconds(Date.now(), 30).getSeconds()
}
])
const presetDates = ref([
{ label: 'Today', value: [new Date(), new Date()] },
{ label: 'This month', value: [startOfMonth(new Date()), endOfMonth(new Date())] },
{
label: 'Last month',
value: [startOfMonth(subMonths(new Date(), 1)), endOfMonth(subMonths(new Date(), 1))]
},
{ label: 'This year', value: [startOfYear(new Date()).getTime(), endOfYear(new Date()).getTime()] }
])
const timeValue = ref({
hours: new Date().getHours(),
minutes: new Date().getMinutes()
})
const secondsValue = ref({
hours: new Date().getHours(),
minutes: new Date().getMinutes(),
seconds: new Date().getSeconds()
})
// startOfWeek & endOfWeek 默認(rèn)以周日作為一周的開(kāi)始，可以傳遞一個(gè)選項(xiàng)對(duì)象，以周一作為一周的開(kāi)始：{ weekStartsOn: 1 }
const options: any = { weekStartsOn: 1 }
const weekValue = ref([startOfWeek(new Date(), options), endOfWeek(new Date(), options)])
const monthValue = ref({
year: new Date().getFullYear(),
month: new Date().getMonth()
})
const yearValue = ref(new Date().getFullYear())
const sizeOptions = [
{
label: 'small',
value: 'small'
},
{
label: 'middle',
value: 'middle'
},
{
label: 'large',
value: 'large'
}
]
const size = ref('middle')
watchEffect(() => {
console.log('dateValue', dateValue.value)
})
watchEffect(() => {
console.log('dateTimeValue', dateTimeValue.value)
})
watchEffect(() => {
console.log('rangeValue', rangeValue.value)
})
watchEffect(() => {
console.log('rangeTimeValue', rangeTimeValue.value)
})
watchEffect(() => {
console.log('maxRangeValue', maxRangeValue.value)
})
watchEffect(() => {
console.log('timeRangeValue', timeRangeValue.value)
})
watchEffect(() => {
console.log('timeValue', timeValue.value)
})
watchEffect(() => {
console.log('secondsValue', secondsValue.value)
})
watchEffect(() => {
console.log('weekValue', weekValue.value)
})
watchEffect(() => {
console.log('monthValue', monthValue.value)
})
watchEffect(() => {
console.log('yearValue', yearValue.value)
})
function disabledDates(date: Date): boolean {
const current = date.getTime()
if (endOfDay(new Date()).getTime() < current && current <= endOfDay(addDays(new Date(), 7)).getTime()) {
return false
}
return true
}
function disabledDatesNextWeek(date: Date): boolean {
const current = date.getTime()
if (endOfDay(new Date()).getTime() < current && current <= endOfDay(addDays(new Date(), 7)).getTime()) {
return true
}
return false
}
interface Filters {
months?: number[] // 0 = Jan, 11 - Dec
years?: number[] // Array of years to disable
times?: {
hours?: number[] // disable specific hours
minutes?: number[] // disable sepcific minutes
seconds?: number[] // disable specific seconds
}
}
const filters = computed<Filters>(() => {
return {
months: [0, 1, 2].map((index: number) => getMonth(addMonths(new Date(), index + 1)))
}
})
</script>
<template>
<div>
<h1>{{ $route.name }} {{ $route.meta.title }}</h1>
<ul class="m-list">
<li>
<a class="u-file" rel="external nofollow" target="_blank">Vue Datepicker</a>
</li>
<li>
<a class="u-file" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" target="_blank">Vue Datepicker Documents</a>
</li>
<li>
<a class="u-file" rel="external nofollow" target="_blank">date-fns</a>
</li>
</ul>
<Space class="mt30" gap="small">
<h1>@vuepic/vue-datepicker</h1>
<Tag color="volcano">{{ pkg.dependencies['@vuepic/vue-datepicker'] }}</Tag>
</Space>
<h2 class="mt30 mb10">基本使用</h2>
<DatePicker v-model="dateValue" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
<h2 class="mt30 mb10">三種大小</h2>
<Space vertical>
<Radio :options="sizeOptions" v-model:value="size" button button-style="solid" />
<DatePicker :size="size" v-model="dateValue" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
</Space>
<h2 class="mt30 mb10">禁用</h2>
<DatePicker disabled v-model="dateValue" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
<h2 class="mt30 mb10">禁用日期</h2>
<h3 class="mb10">不可選擇過(guò)去日期，min-date 支持：Date | string 類(lèi)型</h3>
<DatePicker v-model="dateValue" :min-date="new Date()" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
<h3 class="mt10 mb10">不可選擇未來(lái)日期，max-date 支持：Date | string 類(lèi)型</h3>
<DatePicker
v-model="dateValue"
:max-date="format(new Date(), 'yyyy-MM-dd')"
format="yyyy-MM-dd"
placeholder="請(qǐng)選擇日期"
/>
<h3 class="mt10 mb10"
>只能選擇未來(lái)七天內(nèi)的日期，disabled-dates 支持：Date[] | string[] | (date: Date) => boolean 類(lèi)型</h3
>
<DatePicker v-model="dateValue" :disabled-dates="disabledDates" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
<h3 class="mt10 mb10">不可選擇未來(lái)七天的日期</h3>
<DatePicker
v-model="dateValue"
:disabled-dates="disabledDatesNextWeek"
format="yyyy-MM-dd"
placeholder="請(qǐng)選擇日期"
/>
<h3 class="mt10 mb10">不可選擇明天/后天</h3>
<DatePicker
v-model="dateValue"
:disabled-dates="[addDays(new Date(), 1), addDays(new Date(), 2)]"
format="yyyy-MM-dd"
placeholder="請(qǐng)選擇日期"
/>
<h3 class="mt10 mb10"
>不可選擇周六和周日，disabled-week-days 支持：string[] | number[] 類(lèi)型；0-6, 0是周日, 6是周六</h3
>
<DatePicker v-model="dateValue" :disabled-week-days="[0, 6]" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
<h3 class="mt10 mb10">不可選擇未來(lái)三個(gè)月，filters 支持：Filters 類(lèi)型</h3>
<DatePicker v-model="dateValue" :filters="filters" format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期" />
<h2 class="mt30 mb10">日期時(shí)間選擇器</h2>
<DatePicker
:width="210"
v-model="dateTimeValue"
format="yyyy-MM-dd HH:mm:ss"
show-time
enable-seconds
placeholder="請(qǐng)選擇日期時(shí)間"
/>
<h2 class="mt30 mb10">日期范圍選擇器</h2>
<DatePicker :width="240" v-model="rangeValue" range format="yyyy-MM-dd" placeholder="請(qǐng)選擇日期范圍" />
<h2 class="mt30 mb10">雙日期面板</h2>
<DatePicker
:width="240"
v-model="rangeValue"
format="yyyy-MM-dd"
range
multi-calendars
placeholder="請(qǐng)選擇日期范圍"
/>
<h2 class="mt30 mb10">日期時(shí)間范圍選擇器</h2>
<DatePicker
:width="350"
v-model="rangeTimeValue"
range
show-time
enable-seconds
multi-calendars
format="yyyy-MM-dd HH:mm:ss"
placeholder="請(qǐng)選擇日期時(shí)間范圍"
/>
<h2 class="mt30 mb10">預(yù)設(shè)范圍</h2>
<h3 class="mb10">預(yù)設(shè)常用的日期范圍以提高用戶(hù)體驗(yàn)</h3>
<DatePicker
:width="240"
v-model="rangeValue"
format="yyyy-MM-dd"
range
:preset-dates="presetDates"
multi-calendars
placeholder="請(qǐng)選擇日期范圍"
/>
<h2 class="mt30 mb10">自定義最長(zhǎng)日期可選擇范圍</h2>
<h3 class="mb10">最長(zhǎng)日期可選范圍不超過(guò)7天</h3>
<DatePicker
:width="240"
v-model="maxRangeValue"
format="yyyy-MM-dd"
range
:max-range="7"
placeholder="請(qǐng)選擇日期范圍"
/>
<h2 class="mt30 mb10">時(shí)分選擇器</h2>
<DatePicker
:width="110"
v-model="timeValue"
mode="time"
show-time
mode-height="120"
format="HH:mm"
placeholder="請(qǐng)選擇時(shí)間"
/>
<h2 class="mt30 mb10">時(shí)分秒選擇器</h2>
<DatePicker
:width="130"
v-model="secondsValue"
mode="time"
format="HH:mm:ss"
show-time
enable-seconds
mode-height="120"
placeholder="請(qǐng)選擇時(shí)間"
/>
<h2 class="mt30 mb10">時(shí)分秒范圍選擇器</h2>
<DatePicker
:width="200"
v-model="timeRangeValue"
mode="time"
format="HH:mm:ss"
show-time
range
enable-seconds
mode-height="120"
placeholder="請(qǐng)選擇時(shí)間"
/>
<h2 class="mt30 mb10">周選擇器</h2>
<Space vertical>
<GradientText
:size="24"
:weight="600"
:gradient="{
deg: '90deg',
from: '#09c8ce',
to: '#eb2f96'
}"
>
{{ format(weekValue[0], 'yyyy-MM-dd') + ' ~ ' + format(weekValue[1], 'yyyy-MM-dd') }}
</GradientText>
<DatePicker :width="170" v-model="weekValue" mode="week" format="yyyy年 第ww周" placeholder="請(qǐng)選擇周" />
</Space>
<h2 class="mt30 mb10">月選擇器</h2>
<DatePicker :width="130" v-model="monthValue" mode="month" format="yyyy-MM" placeholder="請(qǐng)選擇月" />
<h2 class="mt30 mb10">年選擇器</h2>
<DatePicker :width="110" v-model="yearValue" mode="year" format="yyyy" placeholder="請(qǐng)選擇年" />
</div>
</template>到此這篇關(guān)于Vue3日期選擇器DatePicker實(shí)例詳解的文章就介紹到這了,更多相關(guān)Vue日期選擇器DatePicker內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Vue3的ts報(bào)錯(cuò):類(lèi)型"{}"上不存在屬性"xxx"的兩種徹底根治解決方法
這篇文章主要給大家介紹了關(guān)于Vue3的ts報(bào)錯(cuò):類(lèi)型"{}"上不存在屬性"xxx"的兩種徹底根治解決方法,這是最近做項(xiàng)目中遇到的一個(gè)問(wèn)題,這里給大家總結(jié)下解決辦法,需要的朋友可以參考下2023-08-08
sortable+element 實(shí)現(xiàn)表格行拖拽的方法示例
這篇文章主要介紹了sortable+element 實(shí)現(xiàn)表格行拖拽的方法示例，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2019-06-06
Vue3播放m3u8視頻的兩種實(shí)現(xiàn)方式示例
這篇文章主要介紹了Vue3播放m3u8視頻的兩種實(shí)現(xiàn)方式,兩種視頻播放器組件分別是vue3-video-play和chimee-player,文中通過(guò)代碼介紹的非常詳細(xì),需要的朋友可以參考下2025-01-01
這篇文章主要介紹了Vue中組件的遞歸和使用問(wèn)題，本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2022-03-03
使用Vue3+ElementPlus前端實(shí)現(xiàn)分片上傳的全過(guò)程
ElementPlus是一套為開(kāi)發(fā)者、設(shè)計(jì)師和產(chǎn)品經(jīng)理準(zhǔn)備的基于Vue?3.0的組件庫(kù),提供了配套設(shè)計(jì)資源,幫助你的網(wǎng)站快速成型,下面這篇文章主要給大家介紹了關(guān)于使用Vue3+ElementPlus前端實(shí)現(xiàn)分片上傳的相關(guān)資料,需要的朋友可以參考下2022-11-11
vue 使用鼠標(biāo)滾動(dòng)加載數(shù)據(jù)的例子
今天小編就為大家分享一篇vue 使用鼠標(biāo)滾動(dòng)加載數(shù)據(jù)的例子，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2019-10-10
這篇文章主要為大家詳細(xì)介紹了vue面包屑組件的封裝方法，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2021-09-09
使用D3.js+Vue實(shí)現(xiàn)一個(gè)簡(jiǎn)單的柱形圖
這篇文章主要介紹了使用D3.js+Vue實(shí)現(xiàn)一個(gè)簡(jiǎn)單的柱形圖,非常不錯(cuò)，具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2018-08-08
這篇文章主要介紹了Vue項(xiàng)目如何打包成移動(dòng)端APP,本文通過(guò)圖文示例相結(jié)合給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友參考下吧2023-12-12
下面小編就為大家分享一篇vue二級(jí)路由設(shè)置方法，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-02-02