jeffwalsh/yii2-date-range

An advanced Yii 2 date range picker input for based on bootstrap-daterangepicker plugin.

yii2-date-range

, _(*1)

An advanced date range picker input for Yii Framework 2 based on dangrossman/bootstrap-daterangepicker plugin. The date range picker widget is styled for Bootstrap 3.x and creates a dropdown menu from which a user can select a range of dates. If the plugin is invoked with no options, it will present two calendars to choose a start and end date from. Optionally, you can provide a list of date ranges the user can select from instead of choosing dates from the calendars. If attached to a text input, the selected dates will be inserted into the text box. Otherwise, you can provide a custom callback function to receive the selection., _(*2)

Additional enhancements added for this widget (by Krajee):, _(*3)

• allows ability to work with Bootstrap input group addons and set the picker position to point at the input-group-addon icon.
• enhanced translation features using yii i18n message files.
• automatically convert format from PHP Date/time format to Moment.js Date/time format.
• automatically trigger change of base field to enforce Yii ActiveField validation
• ability to set the widget to display a preset dropdown of date options within a container (and hidden input).
• style the container options as per your need using templates
• automatically disable date-range based on disabled/readonly options.

Demo

You can see detailed documentation on usage of the extension., _(*4)

Latest Release

The latest version of the extension is release v1.6.6. Refer the CHANGE LOG for details of various releases., _(*5)

Installation

The preferred way to install this extension is through composer., _(*6)

Note: 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., _(*7)

Either run, _(*8)

$ php composer.phar require kartik-v/yii2-date-range "dev-master"

or add, _(*9)

"kartik-v/yii2-date-range": "dev-master"

to the require section of your composer.json file., _(*10)

Usage

DateRangePicker

use kartik\daterange\DateRangePicker;
echo DateRangePicker::widget([
    'model'=>$model,
    'attribute'=>'datetime_range',
    'convertFormat'=>true,
    'pluginOptions'=>[
        'timePicker'=>true,
        'timePickerIncrement'=>30,
        'locale'=>[
            'format'=>'Y-m-d h:i A'
        ]
    ]
]);

or using seperate min/max attributes on model, _(*11)

use kartik\daterange\DateRangePicker;
echo DateRangePicker::widget([
    'model'=>$model,
    'attribute'=>'datetime_range',
    'convertFormat'=>true,
    'startAttribute'=>'datetime_min',
    'endAttribute'=>'datetime_max',
    'pluginOptions'=>[
        'timePicker'=>true,
        'timePickerIncrement'=>30,
        'locale'=>[
            'format'=>'Y-m-d h:i A'
        ]
    ]
]);

License

yii2-date-range is released under the BSD 3-Clause License. See the bundled LICENSE.md for details., _(*12)