elephantsgroup/eg-jdate

Yii2 Jalali date & time

1.0.0 2018-04-05 12:28 UTC

Requires

• php: >=7.0.0
• yiisoft/yii2: >=2.0.0

MIT

• Jalal Jaberi

• extension
• yii
• yii2
• jalali date
• elephantsGroup

README

Yii2 Jalali date & time library based on mohammad-mahdy/yii2-jdate.

Installation

The preferred way to install this extension is through composer.

Either run

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

or add

"elephantsgroup/eg-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' => 'elephantsGroup\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:

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