README

基于dangrossman/bootstrap-daterangepicker插件的先进日期范围选择器输入，适用于Yii Framework 2。日期范围选择器小部件针对Bootstrap 3.x进行样式设计，并创建一个下拉菜单，用户可以从中选择日期范围。如果插件无选项调用，它将展示两个日历来选择开始和结束日期。可选地，您可以为用户提供一个日期范围列表，用户可以从中选择，而不是从日历中选择日期。如果附加到文本输入框，所选日期将被插入到文本框中。否则，您可以提供一个自定义回调函数以接收选择。

此小部件添加的附加增强功能（由Krajee提供）

• 允许与Bootstrap输入组附加组件一起使用，并将选择器位置设置为指向input-group-addon图标。
• 增强使用yii i18n消息文件的功能。
• 自动将格式从PHP日期/时间格式转换为Moment.js日期/时间格式。
• 自动触发基本字段的更改，以强制Yii ActiveField验证。
• 可以将小部件设置为在容器（和隐藏输入）内显示预设的日期选项下拉菜单。
• 使用模板根据您的需求样式化容器选项。
• 根据禁用/只读选项自动禁用日期范围。

演示

您可以在这里找到有关该扩展使用方法的详细文档。

最新版本

此扩展的最新版本是v1.6.6。有关各种版本的详细信息，请参阅变更日志。

安装

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

注意：请检查此扩展的composer.json，以了解其需求和依赖项。请参阅此Web提示/维基，了解如何设置应用程序的composer.json中的minimum-stability设置。

运行以下命令之一：

$ php composer.phar require kartik-v/yii2-date-range "dev-master"

或将其添加到您的composer.json文件的require部分：

"kartik-v/yii2-date-range": "dev-master"

使用

DateRangePicker

use kartik\daterange\DateRangePicker;
echo DateRangePicker::widget([
    'model'=>$model,
    'attribute'=>'datetime_range',
    'convertFormat'=>true,
    'pluginOptions'=>[
        'timePicker'=>true,
        'timePickerIncrement'=>30,
        'locale'=>[
            'format'=>'Y-m-d h:i A'
        ]
    ]
]);

或使用模型上的单独min/max属性

use kartik\daterange\DateRangePicker;
echo DateRangePicker::widget([
    'model'=>$model,
    'attribute'=>'datetime_range',
    'convertFormat'=>true,
    'startAttribute'=>'datetime_min',
    'endAttribute'=>'datetime_max',
    'pluginOptions'=>[
        'timePicker'=>true,
        'timePickerIncrement'=>30,
        'locale'=>[
            'format'=>'Y-m-d h:i A'
        ]
    ]
]);

许可证

yii2-date-range是根据BSD 3-Clause许可证发布的。有关详细信息，请参阅附带LICENSE.md。