README

贾拉利日期和时间是yii2的一个扩展。

安装

安装此扩展的首选方法是通过composer。

运行以下命令：

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

或将以下内容添加到您的composer.json文件的require部分：

"mjm/jdate": "*"

DateTime的用法

安装扩展后，将其添加为组件

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

现在您可以在项目中使用了

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

您可以将日期和时间作为变量访问

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

DatePicker的用法

它是一个小部件，用于创建一个输入框，让用户输入贾拉利日期。

基本用法

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

如果您想设置默认日期，请设置value

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

使用model

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

在active form中使用

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

###DatePicker ClientOptions###

将这些添加到ClientOptions变量中。

####更改日期选择器大小

[
	'cellHeight' => 13,
	'cellWidth'  => 13
]

####更改字体大小

[
	'fontSize' => 25
]

####在日期选择器中使用英语数字

[
	'persianNumbers' => false
]

####日期格式

[
	'formatDate' => 'DD-NM-YYYY hh:m'
]

###DatePicker Theme###

现在日期选择器有两个主题：default和dark。

要设置主题，设置theme变量。

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

###DatePicker Events#####

注意：如果您想重新编写onSelect事件并使用active form，请添加options[id]并添加

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

> 
> to your event function.

####`onHide` Event:

```php
<?= mjm\jdate\DatePicker::widget([
	'model' => $model, 'attribute' => 'date',
	'ClientOptions' => [
		'onHide' => 'function(){alert("Datepicker is now hidden!")}'
	]
]) ?>

####onSelect事件

<?= mjm\jdate\DatePicker::widget([
	'model' => $model, 'attribute' => 'date',
	'ClientOptions' => [
		'onSelect' => 'function(){alert("Date selected!")}'
	]
]) ?>

####onShow事件

<?= mjm\jdate\DatePicker::widget([
	'model' => $model, 'attribute' => 'date',
	'ClientOptions' => [
		'onShow' => 'function(){alert("Hello!")}'
	]
]) ?>