Enhanced Yii2 wrapper for the bootstrap datepicker plugin (sub repo split from yii2-widgets)
Clone or download
Latest commit ac89cc2 Nov 5, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update to release v1.4.3 Sep 4, 2017
src Update to release v1.4.7 Oct 9, 2018
CHANGE.md Update to release v1.4.7 Oct 9, 2018
LICENSE.md Update to release v1.4.4 fix #154 fix #160 fix #161 fix #164 fix #165 f… Jul 13, 2018
README.md Update README Nov 5, 2018
composer.json Update to release v1.4.7 Oct 9, 2018


Krajee Logo

Stable Version Untable Version License Total Downloads Monthly Downloads Daily Downloads

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 Bootstrap 3 and Bootstrap 4 for Yii 2 Framework. The widget 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 kartik-v/yii2-widget-datepicker "@dev"

or add

"kartik-v/yii2-widget-datepicker": "@dev"

to the require section of your composer.json file.

Release Changes

NOTE: Refer the CHANGE LOG for details on changes to various releases.


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


use kartik\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-widget-datepicker is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.