years/yii2-datetimepicker

Bootstrap datetimepicker widget for Yii 2, based on Eonasdan/bootstrap-datetimepicker.

Datetime picker widget

Bootstrap datetimepicker widget for Yii 2, based on Eonasdan/bootstrap-datetimepicker., _(*1)

Installation

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

Either run, _(*3)

php composer.phar require --prefer-dist nkovacs/yii2-datetimepicker "*"

or add, _(*4)

"nkovacs/yii2-datetimepicker": "*"

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

Usage

Once the extension is installed, simply use it in your code:, _(*6)

<?= \nkovacs\datetimepicker\DateTimePicker::widget([
    'name' => 'time',
]); ?>

or as an active field:, _(*7)

<?= $form->field($model, 'time')->widget(\nkovacs\datetimepicker\DateTimePicker::className(), [
    'clientOptions' => [
        'extraFormats' => ['YYYY-MM-DD HH:mm'],
    ],
]) ?>

To show just a datepicker:, _(*8)

<?= $form->field($model, 'time')->widget(\nkovacs\datetimepicker\DateTimePicker::className(), [
    'type' => 'date',
]) ?>

or just a timepicker:, _(*9)

<?= $form->field($model, 'time')->widget(\nkovacs\datetimepicker\DateTimePicker::className(), [
    'type' => 'time',
]) ?>

The widget will load the moment locale file for Yii::$app->language if it can find it., _(*10)

It will also use Yii::$app->formatter->dateFormat, Yii::$app->formatter->timeFormat or Yii::$app->formatter->datetimeFormat depending on type., _(*11)

Use the timestampAttribute property of the validator in this extension to get the parsed timestamp., _(*12)

Both can be overriden using the locale and format options., _(*13)

Validators

The extension comes with an improved datetime validator. Yii's default DateValidator cannot handle time values with the default ICU 'medium' format. The validator adds a type option that specifies what kind of value should be accepted: date, time or datetime., _(*14)

To register the validator, add the following line to your app config file:, _(*15)

\nkovacs\datetimepicker\DateTimeValidator::register();

This replaces the built-in date validator and adds a time and datetime validator:, _(*16)

    ...
    ['timestamp', 'datetime'],
    ['time', 'time'],
    ['date', 'date'],
    ...