janisto/yii2-timepicker

Yii 2 widget for jQuery Timepicker Addon.

Installs: 45 574

Dependents: 3

Suggesters: 0

Security: 0

Stars: 7

Watchers: 4

Forks: 5

Open Issues: 1

Type:yii2-extension

1.1.0 2015-11-12 10:16 UTC

This package is not auto-updated.

Last update: 2021-02-19 21:55:09 UTC


README

Yii 2 widget for jQuery Timepicker Addon.

Software License Build Status Quality Score Packagist Version Total Downloads

Installation

If you do not have Composer, you may install it by following the instructions at getcomposer.org.

You can then install this package using the following command:

php composer.phar require "janisto/yii2-timepicker" "*"

or add

"janisto/yii2-timepicker": "*"

to the require section of your application's composer.json file.

Usage

See jQuery Timepicker options.

For example to use the timepicker with a yii\base\Model:

echo TimePicker::widget([
     //'language' => 'fi',
    'model' => $model,
    'attribute' => 'created_at',
    'mode' => 'datetime',
    'clientOptions' => [
        'dateFormat' => 'yy-mm-dd',
        'timeFormat' => 'HH:mm:ss',
        'showSecond' => true,
    ]
]);
echo TimePicker::widget([
    //'language' => 'fi',
    'model' => $model,
    'attribute' => 'created_at',
    'mode' => 'datetime',
    'inline' => true,
    'clientOptions' => [
        'onClose' => new \yii\web\JsExpression('function(dateText, inst) { console.log("onClose: " + dateText); }'),
        'onSelect' => new \yii\web\JsExpression('function(dateText, inst) { console.log("onSelect: " + dateText); }'),
    ]
]);

The following example will use the name property instead:

echo TimePicker::widget([
     //'language' => 'fi',
    'name'  => 'from_time',
    'value'  => $value,
    'mode' => 'time',
    'clientOptions' => [
        'hour' => date('H'),
        'minute' => date('i'),
        'second' => date('s'),
    ]
]);

You can also use this widget in an yii\widgets\ActiveForm using the yii\widgets\ActiveField::widget() method, for example like this:

echo $form->field($model, 'field')->widget(\janisto\timepicker\TimePicker::className(), [
    //'language' => 'fi',
    'mode' => 'datetime',
    'clientOptions' => [
        'dateFormat' => 'yy-mm-dd',
        'timeFormat' => 'HH:mm:ss',
        'showSecond' => true,
    ]
]);

Contributing

Please see CONTRIBUTING for details.

Credits

License

Public domain. Please see License File for more information.