DateTimePicker 日期时间选择器

在同一个选择器里选择日期和时间

DateTimePicker 由 DatePicker 和 TimePicker 派生,Picker Options 或者其他选项可以参照 DatePicker 和 TimePicker。

日期和时间点

DateTimePicker 日期时间选择器 - 图1

通过设置type属性为datetime,即可在同一个选择器里同时进行日期和时间的选择。快捷选项的使用方法与 Date Picker 相同。

  1. <template>
  2. <div class="block">
  3. <span class="demonstration">默认</span>
  4. <el-date-picker
  5. v-model="value1"
  6. type="datetime"
  7. placeholder="选择日期时间">
  8. </el-date-picker>
  9. </div>
  10. <div class="block">
  11. <span class="demonstration">带快捷选项</span>
  12. <el-date-picker
  13. v-model="value2"
  14. type="datetime"
  15. placeholder="选择日期时间"
  16. align="right"
  17. :picker-options="pickerOptions1">
  18. </el-date-picker>
  19. </div>
  20. <div class="block">
  21. <span class="demonstration">设置默认时间</span>
  22. <el-date-picker
  23. v-model="value3"
  24. type="datetime"
  25. placeholder="选择日期时间"
  26. default-time="12:00:00">
  27. </el-date-picker>
  28. </div>
  29. </template>
  30. <script>
  31. export default {
  32. data() {
  33. return {
  34. pickerOptions1: {
  35. shortcuts: [{
  36. text: '今天',
  37. onClick(picker) {
  38. picker.$emit('pick', new Date());
  39. }
  40. }, {
  41. text: '昨天',
  42. onClick(picker) {
  43. const date = new Date();
  44. date.setTime(date.getTime() - 3600 * 1000 * 24);
  45. picker.$emit('pick', date);
  46. }
  47. }, {
  48. text: '一周前',
  49. onClick(picker) {
  50. const date = new Date();
  51. date.setTime(date.getTime() - 3600 * 1000 * 24 * 7);
  52. picker.$emit('pick', date);
  53. }
  54. }]
  55. },
  56. value1: '',
  57. value2: '',
  58. value3: ''
  59. };
  60. }
  61. };
  62. </script>

日期和时间范围

DateTimePicker 日期时间选择器 - 图2

设置typedatetimerange即可选择日期和时间范围

  1. <template>
  2. <div class="block">
  3. <span class="demonstration">默认</span>
  4. <el-date-picker
  5. v-model="value4"
  6. type="datetimerange"
  7. range-separator="至"
  8. start-placeholder="开始日期"
  9. end-placeholder="结束日期">
  10. </el-date-picker>
  11. </div>
  12. <div class="block">
  13. <span class="demonstration">带快捷选项</span>
  14. <el-date-picker
  15. v-model="value5"
  16. type="datetimerange"
  17. :picker-options="pickerOptions2"
  18. range-separator="至"
  19. start-placeholder="开始日期"
  20. end-placeholder="结束日期"
  21. align="right">
  22. </el-date-picker>
  23. </div>
  24. </template>
  25. <script>
  26. export default {
  27. data() {
  28. return {
  29. pickerOptions2: {
  30. shortcuts: [{
  31. text: '最近一周',
  32. onClick(picker) {
  33. const end = new Date();
  34. const start = new Date();
  35. start.setTime(start.getTime() - 3600 * 1000 * 24 * 7);
  36. picker.$emit('pick', [start, end]);
  37. }
  38. }, {
  39. text: '最近一个月',
  40. onClick(picker) {
  41. const end = new Date();
  42. const start = new Date();
  43. start.setTime(start.getTime() - 3600 * 1000 * 24 * 30);
  44. picker.$emit('pick', [start, end]);
  45. }
  46. }, {
  47. text: '最近三个月',
  48. onClick(picker) {
  49. const end = new Date();
  50. const start = new Date();
  51. start.setTime(start.getTime() - 3600 * 1000 * 24 * 90);
  52. picker.$emit('pick', [start, end]);
  53. }
  54. }]
  55. },
  56. value4: [new Date(2000, 10, 10, 10, 10), new Date(2000, 10, 11, 10, 10)],
  57. value5: ''
  58. };
  59. }
  60. };
  61. </script>

默认的起始与结束时刻

DateTimePicker 日期时间选择器 - 图3

使用datetimerange进行范围选择时,在日期选择面板中选定起始与结束的日期,默认会使用该日期的00:00:00作为起始与结束的时刻;通过选项default-time可以控制选中起始与结束日期时所使用的具体时刻。default-time接受一个数组,数组每项值为字符串,形如12:00:00,其中第一项控制起始日期的具体时刻,第二项控制结束日期的具体时刻。

  1. <template>
  2. <div class="block">
  3. <span class="demonstration">起始日期时刻为 12:00:00</span>
  4. <el-date-picker
  5. v-model="value6"
  6. type="datetimerange"
  7. start-placeholder="开始日期"
  8. end-placeholder="结束日期"
  9. :default-time="['12:00:00']">
  10. </el-date-picker>
  11. </div>
  12. <div class="block">
  13. <span class="demonstration">起始日期时刻为 12:00:00,结束日期时刻为 08:00:00</span>
  14. <el-date-picker
  15. v-model="value7"
  16. type="datetimerange"
  17. align="right"
  18. start-placeholder="开始日期"
  19. end-placeholder="结束日期"
  20. :default-time="['12:00:00', '08:00:00']">
  21. </el-date-picker>
  22. </div>
  23. </template>
  24. <script>
  25. export default {
  26. data() {
  27. return {
  28. value6: '',
  29. value7: ''
  30. };
  31. }
  32. };
  33. </script>

显示代码

Attributes

参数 说明 类型 可选值 默认值
readonly 完全只读 boolean false
disabled 禁用 boolean false
editable 文本框可输入 boolean true
clearable 是否显示清除按钮 boolean true
size 输入框尺寸 string large, small, mini
placeholder 非范围选择时的占位内容 string
start-placeholder 范围选择时开始日期的占位内容 string
end-placeholder 范围选择时结束日期的占位内容 string
time-arrow-control 是否使用箭头进行时间选择 boolean false
type 显示类型 string year/month/date/week/ datetime/datetimerange/daterange date
format 显示在输入框中的格式 string 日期格式 yyyy-MM-dd
align 对齐方式 string left, center, right left
popper-class DateTimePicker 下拉框的类名 string
picker-options 当前时间日期选择器特有的选项参考下表 object {}
range-separator 选择范围时的分隔符 string - '-'
default-value 可选,选择器打开时默认显示的时间 Date 可被new Date()解析
default-time 选中日期后的默认具体时刻 非范围选择时:string / 范围选择时:string[] 非范围选择时:形如12:00:00的字符串;范围选择时:数组,长度为 2,每项值为字符串,形如12:00:00,第一项指定开始日期的时刻,第二项指定结束日期的时刻。不指定会使用时刻 00:00:00
value-format 可选,绑定值的格式。不指定则绑定值为 Date 对象 string 日期格式
name 原生属性 string
unlink-panels 在范围选择器里取消两个日期面板之间的联动 boolean false
prefix-icon 自定义头部图标的类名 string el-icon-date
clear-icon 自定义清空图标的类名 string el-icon-circle-close

Picker Options

参数 说明 类型 可选值 默认值
shortcuts 设置快捷选项,需要传入 { text, onClick } 对象用法参考 demo 或下表 Object[]
disabledDate 设置禁用状态,参数为当前日期,要求返回 Boolean Function
firstDayOfWeek 周起始日 Number 1 到 7 7

Shortcuts

参数 说明 类型 可选值 默认值
text 标题文本 string
onClick 选中后的回调函数,参数是 vm,可通过触发 'pick' 事件设置选择器的值。例如 vm.$emit('pick', new Date()) function

Events

Event Name Description Parameters
change 用户确认选定的值时触发 组件绑定值。格式与绑定值一致,可受 value-format 控制
blur 当 input 失去焦点时触发 组件实例
focus 当 input 获得焦点时触发 组件实例

Methods

方法名 说明 参数
focus 使 input 获取焦点

原文: http://element-cn.eleme.io/#/zh-CN/component/datetime-picker