Vant DatetimePicker 時間選擇

介紹

時間選擇器，支持日期、年月、時分等維度，通常與 彈出層 組件配合使用

引入

import Vue from 'vue';
import { DatetimePicker } from 'vant';

Vue.use(DatetimePicker);

代碼演示

選擇完整時間

<van-datetime-picker
  v-model="currentDate"
  type="datetime"
  :min-date="minDate"
  :max-date="maxDate"
/>

export default {
  data() {
    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      currentDate: new Date()
    };
  }
};

選擇日期（年月日）

<van-datetime-picker
  v-model="currentDate"
  type="date"
  :min-date="minDate"
  :max-date="maxDate"
/>

export default {
  data() {
    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      currentDate: new Date()
    };
  }
};

選擇日期（年月）

通過傳入formatter函數(shù)，可以對選項文字進(jìn)行格式化處理

<van-datetime-picker
  v-model="currentDate"
  type="year-month"
  :min-date="minDate"
  :max-date="maxDate"
  :formatter="formatter"
/>

export default {
  data() {
    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      currentDate: new Date()
    };
  },

  methods: {
    formatter(type, val) {
      if (type === 'year') {
        return `${val}年`;
      } else if (type === 'month') {
        return `${val}月`
      }
      return val;
    }
  }
}

選擇時間

<van-datetime-picker
  v-model="currentTime"
  type="time"
  :min-hour="10"
  :max-hour="20"
/>

export default {
  data() {
    return {
      currentTime: '12:00'
    };
  }
};

選項過濾器

通過傳入filter函數(shù)，可以對選項數(shù)組進(jìn)行過濾，實現(xiàn)自定義時間間隔

<van-datetime-picker
  v-model="currentTime"
  type="time"
  :filter="filter"
/>

export default {
  data() {
    return {
      currentTime: '12:00'
    };
  },

  methods: {
    filter(type, options) {
      if (type === 'minute') {
        return options.filter(option => option % 5 === 0);
      }

      return options;
    }
  }
};

API

Props

DatePicker Props

當(dāng)時間選擇器類型為 date 或 datetime 時，支持以下 props

TimePicker Props

當(dāng)時間選擇器類型為 time 時，支持以下 props

Events

方法

通過 ref 可以獲取到 DatetimePicker 實例并調(diào)用實例方法，詳見 組件實例方法

常見問題

設(shè)置 min-date 或 max-date 后出現(xiàn)頁面卡死的情況？

請注意不要在模板中直接使用類似min-date="new Date()"的寫法，這樣會導(dǎo)致每次渲染組件時傳入一個新的 Date 對象，而傳入新的數(shù)據(jù)會觸發(fā)下一次渲染，從而陷入死循環(huán)。

正確的做法是將min-date作為一個數(shù)據(jù)定義在data函數(shù)中。

在 iOS 系統(tǒng)上初始化組件失敗？

如果你遇到了在 iOS 上無法渲染組件的問題，請確認(rèn)在創(chuàng)建 Date 對象時沒有使用new Date('2020-01-01')這樣的寫法，iOS 不支持以中劃線分隔的日期格式，正確寫法是new Date('2020/01/01')。

對此問題的詳細(xì)解釋：stackoverflow。

在桌面端無法操作組件？

參見在桌面端使用。

是否有年份或月份選擇器？

如果僅需要選擇年份或者月份，建議直接使用 Picker 組件。