README

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

为该部件添加了额外的增强功能（由 Krajee 提供）

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

演示

您可以在 此处 查看扩展的详细使用说明。

最新版本

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

安装

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

注意：请检查此扩展的 composer.json 文件以了解其要求和相关依赖。阅读有关设置应用程序 composer.json 的 minimum-stability 设置的 网络提示 / wiki。

运行以下命令之一

$ 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 文件。