element/examples/docs/datetime-picker.md

日期和时间点

日期和时间点的选择（一）

在两个选择器中选择日期与时间。

<el-date-picker
  type="date"
  placeholder="选择日期">
</el-date-picker>
<el-time-picker
  placeholder="选择时间">
</el-time-picker>

日期和时间点的选择（二）

在一个选择器中选择日期与时间。

<el-date-picker
  type="datetime"
  placeholder="选择日期时间">
</el-date-picker>

含快捷选项（一）

左侧区域可配置快捷选项，例如『今天』、『昨天』等。

<el-date-picker
  type="date"
  placeholder="选择日期"
 :picker-options="pickerOptions1">
</el-date-picker>
<el-time-picker
  placeholder="选择时间">
</el-time-picker>

<script>
  module.exports = {
    data() {
      return {
        pickerOptions1: {
          shortcuts: [{
            text: '今天',
            onClick(picker) {
              picker.$emit('pick', new Date());
            }
          }, {
            text: '昨天',
            onClick(picker) {
              const date = new Date();
              date.setTime(date.getTime() - 3600 * 1000 * 24);
              picker.$emit('pick', date);
            }
          }, {
            text: '一周前',
            onClick(picker) {
              const date = new Date();
              date.setTime(date.getTime() - 3600 * 1000 * 24 * 7);
              picker.$emit('pick', date);
            }
          }]
        }
      };
    }
  };
</script>

含快捷选项（二）

左侧区域可配置快捷选项，例如『今天』、『昨天』等。

<el-date-picker
  type="datetime"
  placeholder="选择日期时间"
  :picker-options="pickerOptions1"
  style="width: 300px;">
</el-date-picker>

<script>
  module.exports = {
    data() {
      return {
        pickerOptions1: {
          shortcuts: [{
            text: '今天',
            onClick(picker) {
              picker.$emit('pick', new Date());
            }
          }, {
            text: '昨天',
            onClick(picker) {
              const date = new Date();
              date.setTime(date.getTime() - 3600 * 1000 * 24);
              picker.$emit('pick', date);
            }
          }, {
            text: '一周前',
            onClick(picker) {
              const date = new Date();
              date.setTime(date.getTime() - 3600 * 1000 * 24 * 7);
              picker.$emit('pick', date);
            }
          }]
        }
      };
    }
  };
</script>

日期和时间范围

日期和时间范围的选择（一）

在两个选择器中选择。

<el-date-picker
  type="datetime"
  placeholder="选择开始时间">
</el-date-picker>
<el-date-picker
  type="datetime"
  placeholder="选择结束时间">
</el-date-picker>

日期和时间范围的选择（二）

在一个选择器中选择。

<el-date-picker
  type="datetimerange"
  placeholder="选择时间范围"
  style="width:340px">
</el-date-picker>

含快捷选项

左侧区域可配置快捷选项，例如『最近一周』、『最近一个月』等。

<el-date-picker
  type="datetimerange"
  :picker-options="pickerOptions2"
  placeholder="选择时间范围"
  style="width:340px">
</el-date-picker>

<script>
  module.exports = {
    data() {
      return {
        pickerOptions2: {
          shortcuts: [{
            text: '最近一周',
            onClick(picker) {
              const end = new Date();
              const start = new Date();
              start.setTime(start.getTime() - 3600 * 1000 * 24 * 7);
              picker.$emit('pick', [start, end]);
            }
          }, {
            text: '最近一个月',
            onClick(picker) {
              const end = new Date();
              const start = new Date();
              start.setTime(start.getTime() - 3600 * 1000 * 24 * 30);
              picker.$emit('pick', [start, end]);
            }
          }, {
            text: '最近三个月',
            onClick(picker) {
              const end = new Date();
              const start = new Date();
              start.setTime(start.getTime() - 3600 * 1000 * 24 * 90);
              picker.$emit('pick', [start, end]);
            }
          }]
        }
      };
    }
  };
</script>

日期范围和时间范围选择

在两个选择器中分别选择日期范围和时间范围。

<el-date-picker
  type="daterange"
  placeholder="选择日期范围"
  style="width:220px">
</el-date-picker>
<el-time-picker
  is-range
  placeholder="选择时间范围">
</el-time-picker>

环比时间

选择两个时间作为限制条件，以得到统计量在这两个时间段的环比数据。

周环比

<el-date-picker
  type="week"
  placeholder="选择开始周">
</el-date-picker>
<el-date-picker
  type="week"
  placeholder="选择结束周">
</el-date-picker>

月环比

<el-date-picker
  type="month"
  placeholder="选择开始月">
</el-date-picker>
<el-date-picker
  type="month"
  placeholder="选择结束月">
</el-date-picker>

年环比

<el-date-picker
  type="year"
  placeholder="选择开始年">
</el-date-picker>
<el-date-picker
  type="year"
  placeholder="选择结束年">
</el-date-picker>

API

参数	说明	类型	可选值	默认值
value	绑定值，需双向绑定	String
format	时间日期格式化	String	年 yyyy, 月 MM, 日 dd, 小时 HH, 分 mm, 秒 ss	'yyyy-MM-dd'
type	显示类型	String	year, month, date, datetime, week	date
readonly	只读	Boolean		false
placeholder	占位内容	String
shortcuts	快捷选项列表，配置信息查看下表	Object[]

shortcuts

参数	说明	类型	可选值	默认值
text	标题	String
onClick	选中后会调用函数，参数是 vm，设置值通过触发 'pick' 事件。例如 vm.$emit('pick', new Date())	Function