janisto/yii2-timepicker

Yii 2 widget for jQuery Timepicker Addon.

1.1.0 2015-11-12 10:16 UTC

Requires

• php: >=5.4.0
• bower-asset/jqueryui-timepicker-addon: >=1.5.2
• yiisoft/yii2: *
• yiisoft/yii2-jui: >=2.0.4

Requires (Dev)

• phpunit/phpunit: ~4.5
• scrutinizer/ocular: ~1.1

public domain

• Jani Mikkonen

• time
• date
• extension
• datetime
• widget
• yii2
• timepicker

README

Yii 2 widget for jQuery Timepicker Addon.

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

• Jani Mikkonen
• All Contributors

License

Public domain. Please see License File for more information.