DatePicker 日期选择器

优质
小牛编辑
119浏览
2023-12-01

用于选择或输入日期

选择日

以「日」为基本单位,基础的日期选择控件

你可以在 [model] 中定义一个初始值,如果留空,则优先显示当前时间。

<el-date-picker (modelChange)="handle($event)"
  (clear-click)="clearClickHandle($event)">
</el-date-picker>
<script type="text">
// in component:
handle(time: number): void {
  // [time] is string
  // date style follow format props
  console.log(time)
}
</script>

日期格式

预定义日期格式

[format] 属性非常强大,你可以发挥自己的想象力来定义它的格式。

<el-date-picker (modelChange)="handle($event)"
  [format]="'yyyy年MM月-dd日'">
</el-date-picker>

以月为单位

隐藏日期,以月为单位选择

[hidden-day] 可以隐藏日期的基本单位,同时你可以通过 format 来统一输出格式。

<el-date-picker (modelChange)="handle($event)"
  [format]="'yyyy - MM'" [hidden-day]="true">
</el-date-picker>

禁用

禁用整个日期组件

<el-date-picker (modelChange)="handle($event)"
  [elDisabled]="true">
</el-date-picker>

DatePicker Attributes

参数说明类型可选值默认值
model初始时间,无初始时间自动定位至当前时间string | Date | number
elDisabled禁用组件boolean
clearable显示清除按钮boolean1
change-on-blur失焦关闭时立即触发一次更新boolean
clear-click清除按钮点击事件EventEmitter
icon-click右侧图标按钮点击事件EventEmitter
size输入框尺寸stringlarge, small, mini
align对齐方式stringleft, rightleft
placeholder占位文字string选择日期
panel-absolute日期选择下拉框使用绝对定位boolean1
panel-index日期选择下拉框的 z-index 值number200
panel-width日期选择下拉框的 宽度number
format日期格式化样本stringyyyy,月 MM,日 dd'yyyy-MM-dd'
hidden-day以月为基本单位,隐藏日期boolean