Datepicker

API reference › Bootstrap 6 › Datepicker

class	`yii2\extensions\bootstrap6\Datepicker`
Extends	`InputWidget` » `yii\widgets\InputWidget` » `yii\base\Widget` » `yii\base\Component` » `yii\base\BaseObject`
Implements	`yii\base\ViewContextInterface`, `yii\base\Configurable`
Uses traits	`AttributesTrait`, `BootstrapWidgetTrait`
Source	`src/Datepicker.php`

Renders a Bootstrap datepicker as a text input, or as an inline calendar bound to a hidden input.

Every option is emitted as the data-bs-* attribute read by the plugin. In inline mode the calendar container carries the attributes and receives the id {id}-datepicker, and the selected dates default to the comma-separated value of the hidden input.

Properties

Property	Type	Description	Defined by
`$attribute`	`string\|null`	The model attribute that this widget is associated with. Default: `null`.	`yii\widgets\InputWidget`
`$autoIdPrefix` static	`string`	The prefix to the automatically generated widget IDs. Default: `'w'`.	`yii\base\Widget`
`$behaviors` read-only	`array<yii\base\Behavior<static>>`	List of behaviors attached to this component.	`yii\base\Component`
`$clientEvents`	`array<string,` `yii\web\JsExpression\|string>`	Event handlers attached to the widget element, as event name => JavaScript handler source. Default: `[]`.	`BootstrapWidgetTrait`
`$clientOptions`	`array<string, mixed>\|false`	Options passed to the plugin constructor, or `false` to skip the JavaScript initialization. Default: `[]`.	`BootstrapWidgetTrait`
`$containerOptions`	`array<string, mixed>`	HTML attributes of the inline calendar container. Default: `[]`.	`Datepicker`
`$dateFormat`	`array<string, mixed>\|null`	`Intl. Default:` null`.	`Datepicker`
`$dateMax`	`string\|null`	Latest selectable date in `YYYY-MM-DD` format, or `null` for no limit. Default: `null`.	`Datepicker`
`$dateMin`	`string\|null`	Earliest selectable date in `YYYY-MM-DD` format, or `null` for no limit. Default: `null`.	`Datepicker`
`$displayMonthsCount`	`int\|null`	Number of months displayed side by side, or `null` for the plugin default (`1`). Default: `null`.	`Datepicker`
`$field`	`yii\widgets\ActiveField`	Active input field, which triggers this widget rendering. Default: `null`. Available since 2.0.11.	`yii\widgets\InputWidget`
`$firstWeekday`	`int\|null`	First day of the week from `0` (Sunday) to `6` (Saturday), or `null` for the plugin default (`1`). Default: `null`.	`Datepicker`
`$id`	`string`	Id of the widget.	`yii\base\Widget`
`$inline`	`bool`	Whether to render the calendar inline instead of a popup bound to a text input. Default: `false`.	`Datepicker`
`$locale`	`string\|null`	Locale used to format the dates, for example `de-DE`, or `null` for the browser locale. Default: `null`.	`Datepicker`
`$model`	`yii\base\Model\|null`	The data model that this widget is associated with. Default: `null`.	`yii\widgets\InputWidget`
`$name`	`string\|null`	The input name. Default: `null`.	`yii\widgets\InputWidget`
`$options`	`array`	The HTML attributes for the input tag. Default: `[]`.	`yii\widgets\InputWidget`
`$placement`	`string\|null`	Popup position relative to the input (`left`, `center`, `right`, `auto`), or `null` for the plugin default. Default: `null`.	`Datepicker`
`$selectedDates`	`list<string>`	Preselected dates in `YYYY-MM-DD` format, taking precedence over the initial input value. Default: `[]`.	`Datepicker`
`$selectionMode`	`string\|null`	Selection mode (`single`, `multiple`, `multiple-ranged`), or `null` for the plugin default (`single`). Default: `null`.	`Datepicker`
`$value`	`string`	The input value. Default: `null`.	`yii\widgets\InputWidget`
`$view`	`yii\web\View`	The view object that can be used to render views or view files.	`yii\base\Widget`
`$viewPath` read-only	`string`	The directory containing the view files for this widget.	`yii\base\Widget`

Methods

Method	Description	Defined by
`__construct()`	Constructor.	`yii\base\BaseObject`
`__call()`	Calls the named method which is not a class method.	`yii\base\Component`
`__clone()`	This method is called after the object is created by cloning an existing one.	`yii\base\Component`
`__get()`	Returns the value of a component property.	`yii\base\Component`
`__isset()`	Checks if a property is set, i.e. defined and not null.	`yii\base\Component`
`__set()`	Sets the value of a component property.	`yii\base\Component`
`__unset()`	Sets a component property to be null.	`yii\base\Component`
`addAttributes()`	Adds a set of HTML attributes; attributes already set with the same name are replaced.	`AttributesTrait`
`addClass()`	Adds one or more CSS classes to the existing classes; duplicated classes are collapsed.	`AttributesTrait`
`addCssStyle()`	Adds CSS style properties to the `style` attribute.	`AttributesTrait`
`afterRun()`	This method is invoked right after a widget is executed.	`yii\base\Widget`
`attachBehavior()`	Attaches a behavior to this component.	`yii\base\Component`
`attachBehaviors()`	Attaches a list of behaviors to the component.	`yii\base\Component`
`attribute()`	Sets an HTML attribute value.	`AttributesTrait`
`beforeRun()`	This method is invoked right before the widget is executed.	`yii\base\Widget`
`begin()` static	Begins a widget.	`yii\base\Widget`
`behaviors()`	Returns a list of behaviors that this component should behave as.	`yii\base\Component`
`canGetProperty()`	Returns a value indicating whether a property can be read.	`yii\base\Component`
`canSetProperty()`	Returns a value indicating whether a property can be set.	`yii\base\Component`
`class()`	Replaces the existing CSS classes with the specified ones.	`AttributesTrait`
`className()` static	Returns the fully qualified name of this class.	`yii\base\BaseObject`
`detachBehavior()`	Detaches a behavior from the component.	`yii\base\Component`
`detachBehaviors()`	Detaches all behaviors from the component.	`yii\base\Component`
`end()` static	Ends a widget.	`yii\base\Widget`
`ensureBehaviors()`	Makes sure that the behaviors declared in `behaviors()` are attached to this component.	`yii\base\Component`
`getBehavior()`	Returns the named behavior object.	`yii\base\Component`
`getBehaviors()`	Returns all behaviors attached to this component.	`yii\base\Component`
`getId()`	Returns the ID of the widget.	`yii\base\Widget`
`getView()`	Returns the view object that can be used to render views or view files.	`yii\base\Widget`
`getViewPath()`	Returns the directory containing the view files for this widget.	`yii\base\Widget`
`hasEventHandlers()`	Returns a value indicating whether there is any handler attached to the named event.	`yii\base\Component`
`hasMethod()`	Returns a value indicating whether a method is defined.	`yii\base\Component`
`hasProperty()`	Returns a value indicating whether a property is defined for this component.	`yii\base\Component`
`init()`	Initializes the widget and validates the closed option sets.	`Datepicker`
`off()`	Detaches an existing event handler from this component.	`yii\base\Component`
`on()`	Attaches an event handler to an event.	`yii\base\Component`
`render()`	Renders a view.	`yii\base\Widget`
`renderFile()`	Renders a view file.	`yii\base\Widget`
`run()`		`Datepicker`
`setId()`	Sets the ID of the widget.	`yii\base\Widget`
`setView()`	Sets the view object to be used by this widget.	`yii\base\Widget`
`trigger()`	Triggers an event.	`yii\base\Component`
`widget()` static	Creates a widget instance and runs it.	`yii\base\Widget`
`dataAttributes()` protected	Returns the `data-bs-*` attributes of the plugin element.	`Datepicker`
`hasModel()` protected		`yii\widgets\InputWidget`
`pluginInitialization()` protected		`Datepicker`
`registerClientEvents()` protected	Registers the JavaScript event handlers listed in `$clientEvents` at `View::POS_END`.	`BootstrapWidgetTrait`
`registerPlugin()` protected	Registers the plugin asset, the plugin initialization when needed, and the `$clientEvents`.	`BootstrapWidgetTrait`
`renderInline()` protected	Renders the inline calendar container with the hidden input that receives the selected dates.	`Datepicker`
`renderInputHtml()` protected	Render a HTML input tag.	`yii\widgets\InputWidget`

Events

Event	Type	Description	Defined by
`EVENT_INIT`	`yii\base\Event`	An event that is triggered when the widget is initialized via `init()`. Event name: `'init'`. Available since 2.0.11.	`yii\base\Widget`
`EVENT_BEFORE_RUN`	`yii\base\WidgetEvent`	An event raised right before executing a widget. Event name: `'beforeRun'`. Available since 2.0.11.	`yii\base\Widget`
`EVENT_AFTER_RUN`	`yii\base\WidgetEvent`	An event raised right after executing a widget. Event name: `'afterRun'`. Available since 2.0.11.	`yii\base\Widget`

Constants

Constant	Value	Description	Defined by
`PLACEMENTS`	`['left', 'center', 'right', 'auto']`	Allowed values of `$placement`.	`Datepicker`
`SELECTION_MODES`	`['single', 'multiple', 'multiple-ranged']`	Allowed values of `$selectionMode`.	`Datepicker`

Property details

$dateFormat

public array<string, mixed>|null $dateFormat = null

`Intl.

DateTimeFormatoptions used to display the dates, ornull` for the locale default.

Method details

init()

public function init(): void

Initializes the widget and validates the closed option sets.

Throws

yii\base\InvalidConfigException: if $selectionMode, $placement or $firstWeekday is invalid.

run()

public function run(): string

Returns

string

dataAttributes()

protected function dataAttributes(list<string> $selectedDates): array<string, mixed>

Returns the data-bs-* attributes of the plugin element.

Parameters

Parameter	Type	Description
`$selectedDates`	`list<string>`	Preselected dates.

Returns

array<string, mixed>

pluginInitialization()

protected function pluginInitialization(string $name, string $element, string $options): string

Parameters

Parameter	Type	Description
`$name`	`string`
`$element`	`string`
`$options`	`string`

Returns

string

renderInline()

protected function renderInline(): string

Renders the inline calendar container with the hidden input that receives the selected dates.

Returns

string