---
url: /docs/forms/components/datePicker.md
---
# DatePicker 组件

[ElementPlus DatePicker 组件](https://element-plus.org/zh-CN/component/date-picker.html)
以下是去掉方法说明后面参数类型的中文文档，方法标题不使用反引号：

# 方法说明

### 设置只读

```php
$this->readonly(true);
```

只读。

***

### 设置禁用状态

```php
$this->disabled(true);
```

禁用。

***

### 设置可编辑状态

```php
$this->editable(true);
```

文本框可输入。

***

### 设置是否显示清除按钮

```php
$this->clearable(true);
```

是否显示清除按钮。

***

### 设置输入框尺寸

```php
$this->size('medium');
```

输入框尺寸。

***

### 设置占位内容

```php
$this->placeholder('请输入内容');
```

非范围选择时的占位内容。

***

### 设置开始日期占位内容

```php
$this->startPlaceholder('开始日期');
```

范围选择时开始日期的占位内容。

***

### 设置结束日期占位内容

```php
$this->endPlaceholder('结束日期');
```

范围选择时结束日期的占位内容。

***

### 设置显示类型

```php
$this->type('date');
```

显示类型。

***

### 设置输入框格式

```php
$this->format('YYYY-MM-DD');
```

显示在输入框中的格式。

***

### 设置对齐方式

```php
$this->align('center');
```

对齐方式。

***

### 设置下拉框类名

```php
$this->popperClass('custom-class');
```

DatePicker 下拉框的类名。

***

### 设置选择器特有的选项

```php
$this->pickerOptions($options);
```

当前时间日期选择器特有的选项。

***

### 设置范围选择分隔符

```php
$this->rangeSeparator('至');
```

选择范围时的分隔符。

***

### 设置默认值

```php
$this->defaultValue('2023-01-01');
```

可选，选择器打开时默认显示的时间。

***

### 设置范围选择时的默认时间

```php
$this->defaultTime(['12:00', '18:00']);
```

范围选择时选中日期所使用的当日内具体时刻。

***

### 设置绑定值的格式

```php
$this->valueFormat('YYYY-MM-DD');
```

可选，绑定值的格式。不指定则绑定值为 Date 对象。

***

### 设置原生属性

```php
$this->name('date-picker');
```

原生属性。

***

### 设置取消联动

```php
$this->unlinkPanels(true);
```

在范围选择器里取消两个日期面板之间的联动。

***

### 设置自定义头部图标类名

```php
$this->prefixIcon('custom-icon');
```

自定义头部图标的类名。

***

### 设置自定义清空图标类名

```php
$this->clearIcon('custom-clear-icon');
```

自定义清空图标的类名。

***

### 设置是否触发表单校验

```php
$this->validateEvent(true);
```

输入时是否触发表单的校验。