element/examples/docs/datetime-picker.md

239 lines
6.4 KiB
Markdown
Raw Normal View History

2016-07-27 06:15:02 +00:00
<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);
}
}]
},
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]);
}
}]
2016-08-11 04:20:29 +00:00
},
value1: '',
value2: '',
value3: new Date(),
value4: '',
value5: '',
value6: '',
value7: '',
value8: '',
value9: '',
value10: '',
value11: '',
value12: '',
value13: '',
value14: '',
value15: '',
value16: ''
2016-07-27 06:15:02 +00:00
};
}
};
</script>
2016-08-29 11:01:42 +00:00
<style>
.demo-block.demo-datetime-picker .source {
padding: 0;
display: flex;
}
.demo-datetime-picker .block {
padding: 30px 0;
text-align: center;
border-right: solid 1px #EFF2F6;
flex: 1;
&:last-child {
border-right: none;
2016-07-27 06:15:02 +00:00
}
2016-08-29 11:01:42 +00:00
}
.demo-datetime-picker .demonstration {
display: block;
color: #8492a6;
font-size: 14px;
margin-bottom: 20px;
}
</style>
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
## 日期时间选择器
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
在同一个选择器里选择日期和时间
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
### 日期和时间点
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
:::demo 通过设置`type`属性为`datetime`,即可在同一个选择器里同时进行日期和时间的选择。快捷选项的使用方法与 Date Picker 相同。
2016-07-27 06:15:02 +00:00
```html
2016-08-29 11:01:42 +00:00
<template>
<div class="block">
<span class="demonstration">默认</span>
<el-date-picker
v-model="value1"
type="datetime"
placeholder="选择日期时间">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">带快捷选项</span>
<el-date-picker
v-model="value2"
type="datetime"
placeholder="选择日期时间"
:picker-options="pickerOptions1">
</el-date-picker>
</div>
</template>
2016-07-27 06:15:02 +00:00
<script>
2016-08-29 11:01:42 +00:00
export default {
2016-07-27 06:15:02 +00:00
data() {
return {
pickerOptions1: {
shortcuts: [{
text: '今天',
onClick(picker) {
picker.$emit('pick', new Date());
}
}, {
text: '昨天',
onClick(picker) {
const date = new Date();
2016-08-29 11:01:42 +00:00
picker.$emit('pick', new Date(date.getTime() - 3600 * 1000 * 24));
2016-07-27 06:15:02 +00:00
}
}, {
text: '一周前',
onClick(picker) {
const date = new Date();
2016-08-29 11:01:42 +00:00
picker.$emit('pick', new Date(date.getTime() - 3600 * 1000 * 24 * 7));
2016-07-27 06:15:02 +00:00
}
}]
2016-08-11 04:20:29 +00:00
},
2016-08-29 11:01:42 +00:00
value1: '',
value2: ''
2016-07-27 06:15:02 +00:00
};
}
};
</script>
```
2016-08-29 11:01:42 +00:00
:::
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
### 日期和时间范围
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
:::demo 设置`type`为`datetimerange`即可选择日期和时间范围
2016-07-27 06:15:02 +00:00
```html
2016-08-29 11:01:42 +00:00
<template>
<div class="block">
<span class="demonstration">默认</span>
<el-date-picker
v-model="value3"
type="datetimerange"
placeholder="选择时间范围"
style="width:260px">
2016-08-29 11:01:42 +00:00
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">带快捷选项</span>
<el-date-picker
v-model="value4"
type="datetimerange"
:picker-options="pickerOptions2"
placeholder="选择时间范围"
style="width:260px">
2016-08-29 11:01:42 +00:00
</el-date-picker>
</div>
</template>
2016-07-27 06:15:02 +00:00
<script>
2016-08-29 11:01:42 +00:00
export default {
2016-07-27 06:15:02 +00:00
data() {
return {
pickerOptions2: {
shortcuts: [{
text: '最近一周',
onClick(picker) {
const end = new Date();
2016-08-29 11:01:42 +00:00
const start = end.getTime() - 3600 * 1000 * 24 * 7;
2016-07-27 06:15:02 +00:00
picker.$emit('pick', [start, end]);
}
2016-08-29 11:01:42 +00:00
}, {
2016-07-27 06:15:02 +00:00
text: '最近一个月',
onClick(picker) {
const end = new Date();
2016-08-29 11:01:42 +00:00
const start = end.getTime() - 3600 * 1000 * 24 * 30;
picker.$emit('pick', [start, end]);
2016-07-27 06:15:02 +00:00
}
2016-08-29 11:01:42 +00:00
}, {
2016-07-27 06:15:02 +00:00
text: '最近三个月',
onClick(picker) {
const end = new Date();
2016-08-29 11:01:42 +00:00
const start = end.getTime() - 3600 * 1000 * 24 * 90;
2016-07-27 06:15:02 +00:00
picker.$emit('pick', [start, end]);
}
}]
2016-08-29 11:01:42 +00:00
},
value3: '',
value4: ''
2016-07-27 06:15:02 +00:00
};
}
};
</script>
```
2016-08-29 11:01:42 +00:00
:::
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
### Attributes
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
2016-09-02 05:56:47 +00:00
| readonly | 只读 | boolean | — | false |
| placeholder | 占位内容 | string | — | — |
2016-08-29 11:01:42 +00:00
| type | 显示类型 | string | year/month/date/datetime/week | date |
| format | 时间日期格式化 | string | 年 `yyyy`,月 `MM`,日 `dd`<br>小时 `HH`,分 `mm`,秒 `ss` | yyyy-MM-dd |
2016-09-02 05:56:47 +00:00
| shortcuts | 快捷选项列表,配置信息<br>查看下表 | object[] | — | — |
2016-07-27 06:15:02 +00:00
2016-08-29 11:01:42 +00:00
### Shortcuts
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
2016-09-02 05:56:47 +00:00
| text | 标题文本 | string | — | — |
| onClick | 选中后的回调函数,参数是 vm可通过触发 'pick' 事件设置<br>选择器的值。例如 vm.$emit('pick', new Date()) | function | — | — |
2016-07-27 06:15:02 +00:00