mohammad-mahdy/yii2-jdate

Jalali date & time.

Installs: 175

Dependents: 0

Stars: 3

Watchers: 3

Forks: 7

Open Issues: 4

Language: JavaScript

0.8 2015-07-18 09:47 UTC

README

Jalali date & time is an extension for yii2.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist mohammad-mahdy/yii2-jdate "*"

or add

"mohammad-mahdy/yii2-jdate": "*"

to the require section of your composer.json file.

Usage of DateTime

Once the extension is installed, add it as a component :

'jdate' => [
    'class' => 'jDate\DateTime'
]

Now you can use in your project:

Yii::$app->jdate->date('Y-m-d');

You can access dates and times as variable :

Yii::$app->jdate->Y;

Usage of DatePicker

It is a widget to make a input, box to giver jalali date from user.

A basic usage:

<?= jDate\DatePicker::widget([
    'name' => 'datepicker'
]) ?>

If you want set default date set value:

<?= jDate\DatePicker::widget([
    'name' => 'datepicker', 'value' => '1394/01/01'
]) ?>

Using a model:

<?= jDate\DatePicker::widget([
    'model' => $model, 'attribute' => 'date'
]) ?>

Use in active form:

<?= $form->field($model, 'fieldname')->widget(jDate\DatePicker::className()) ?>

Datepicker ClientOptions

Add these to ClientOptions var.

Change date picker size:
[
    'cellHeight' => 13,
    'cellWidth'  => 13
]
Change font size:
[
    'fontSize' => 25
]
Use english numbers in date picker:
[
    'persianNumbers' => false
]
Date format:
[
    'formatDate' => 'DD-NM-YYYY hh:m'
]

Datepicker Theme

Now date picker have 2 theme default and dark.

For set theme set theme var.

<?= jDate\DatePicker::widget([
    'model' => $model, 'attribute' => 'date', 'theme' => 'dark'
]) ?>

Datepicker Events

NOTE : If you want rewriting onSelect event and using active form add options[id] and add

$('#your id').trigger('change');

to your event function.

onHide Event:
<?= jDate\DatePicker::widget([
    'model' => $model, 'attribute' => 'date',
    'ClientOptions' => [
        'onHide' => 'function(){alert("Datepicker is now hidden!")}'
    ]
]) ?>
onSelect Event:
<?= jDate\DatePicker::widget([
    'model' => $model, 'attribute' => 'date',
    'ClientOptions' => [
        'onSelect' => 'function(){alert("Date selected!")}'
    ]
]) ?>
onShow Event:
<?= jDate\DatePicker::widget([
    'model' => $model, 'attribute' => 'date',
    'ClientOptions' => [
        'onShow' => 'function(){alert("Hello!")}'
    ]
]) ?>