Enhanced Yii2 wrapper for the bootstrap datepicker plugin (sub repo split from yii2-widgets).

v1.4.1 2017-02-27 09:07 UTC

This package is not auto-updated.

Last update: 2023-01-27 14:06:11 UTC


The DatePicker widget is a Yii 2 wrapper for the Bootstrap DatePicker plugin with various enhancements. The plugin is a fork of Stefan Petre's DatePicker (of eyecon.ro), with improvements by @eternicode. The widget is specially styled for Yii framework 2.0 and Bootstrap 3 and allows graceful degradation to a normal HTML text input, if the browser does not support JQuery. The widget supports these markups:

  • Simple Input Markup
  • Component Markup - Addon Prepended
  • Component Markup - Addon Appended
  • Inline / Embedded Markup
  • Date Range Markup (from and to dates)
  • Solo Button Markup

NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets.


The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability settings for your application's composer.json.

To install, either run

$ php composer.phar require integready/yii2-datepicker-widget "@dev"

or add

"integready/yii2-datepicker-widget": "@dev"

to the require section of your composer.json file.

Latest Release

NOTE: The latest version of the module is v1.3.9. Refer the CHANGE LOG for details.


You can refer detailed documentation and demos on usage of the extension.


use integready\date\DatePicker;

// usage without model
echo '<label>Check Issue Date</label>';
echo DatePicker::widget([
	'name' => 'check_issue_date', 
	'value' => date('d-M-Y', strtotime('+2 days')),
	'options' => ['placeholder' => 'Select issue date ...'],
	'pluginOptions' => [
		'format' => 'dd-M-yyyy',
		'todayHighlight' => true


yii2-datepicker-widget is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.