README

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

安装

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

运行以下命令：

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

或者添加以下内容到你的 composer.json 文件的 require 部分。

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

require

DateTime 的使用

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

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

现在你可以在项目中使用它

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

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

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

DatePicker 的使用

这是一个小部件，用于创建一个输入框，从用户那里获取贾拉利日期。

基本用法

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

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

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

使用 model

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

在 active form 中使用

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

###DatePicker ClientOptions###

将这些添加到 ClientOptions 变量中。

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

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

####更改字体大小

[
	'fontSize' => 25
]

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

[
	'persianNumbers' => false
]

####日期格式

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

###DatePicker Theme###

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

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

<?= 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
<?= jDate\DatePicker::widget([
	'model' => $model, 'attribute' => 'date',
	'ClientOptions' => [
		'onHide' => 'function(){alert("Datepicker is now hidden!")}'
	]
]) ?>

####onSelect 事件

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

####onShow 事件

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