• DateTimePicker 日期时间选择器
    • 日期和时间点
    • 日期和时间范围
    • 默认的起始与结束时刻
    • Attributes
    • Picker Options
    • Shortcuts
    • Events
    • Methods

    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