---
url: /docs/forms/components/timePicker.md
---
# TimePicker 组件

# 时间选择器组件方法

### 设置完全只读

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

完全只读，默认值: false。

***

### 设置禁用状态

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

禁用，默认值: false。

***

### 设置文本框可输入

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

文本框可输入，默认值: true。

***

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

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

是否显示清除按钮，默认值: true。

***

### 设置输入框尺寸

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

输入框尺寸，可选值: medium / small / mini。

***

### 设置非范围选择时的占位内容

```php
$this->placeholder('请选择时间');
```

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

***

### 设置范围选择时开始日期的占位内容

```php
$this->startPlaceholder('开始时间');
```

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

***

### 设置范围选择时结束日期的占位内容

```php
$this->endPlaceholder('结束时间');
```

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

***

### 设置是否为时间范围选择

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

是否为时间范围选择，仅对 `<el-time-picker>` 有效，默认值: false。

***

### 设置是否使用箭头进行时间选择

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

是否使用箭头进行时间选择，仅对 `<el-time-picker>` 有效，默认值: false。

***

### 设置对齐方式

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

对齐方式，可选值: left / center / right，默认值: left。

***

### 设置 TimePicker 下拉框的类名

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

TimePicker 下拉框的类名。

***

### 设置当前时间日期选择器特有的选项

```php
$this->pickerOptions(['option1' => 'value1']);
```

当前时间日期选择器特有的选项，默认值: {}。

***

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

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

选择范围时的分隔符，默认值: '-'。

***

### 设置绑定值的格式

```php
$this->valueFormat('HH:mm:ss');
```

可选，仅在 TimePicker 时可用，绑定值的格式。不指定则绑定值为 Date 对象。

***

### 设置选择器打开时默认显示的时间

```php
$this->defaultValue('12:00');
```

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

***

### 设置原生属性 name

```php
$this->name('timePickerName');
```

原生属性。

***

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

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

自定义头部图标的类名，默认值: el-icon-time。

***

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

```php
$this->clearIcon('el-icon-circle-close');
```

自定义清空图标的类名，默认值: el-icon-circle-close。