elephantsgroup/eg-jdate

Yii2 Jalali date & time

Jalali Date

Yii2 Jalali date & time library based on mohammad-mahdy/yii2-jdate., _(*1)

Installation

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

Either run, _(*3)

php composer.phar require --prefer-dist elephantsgroup/eg-jdate "*"

or add, _(*4)

"elephantsgroup/eg-jdate": "*"

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

Usage of DateTime

Once the extension is installed, add it as a component :, _(*6)

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

Now you can use in your project:, _(*7)

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

You can access dates and times as variable :, _(*8)

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

Usage of DatePicker

It is a widget to make a input, box to giver jalali date from user., _(*9)

A basic usage:, _(*10)

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

If you want set default date set value:, _(*11)

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

Using a model:, _(*12)

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

Use in active form:, _(*13)

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

Datepicker ClientOptions

Add these to ClientOptions var., _(*14)

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

For set theme set theme var., _(*16)

<?= 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, _(*17)

```javascript $('#your id').trigger('change');, <sub>(*18)</sub>

> 
> to your event function.

####`onHide` Event:

```php
<?= 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!")}'
    ]
]) ?>