README

Date Time Picker For Yii2

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist xinyeweb/yii2-datetimepicker "*"

or add

"xinyeweb/yii2-datetimepicker": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, simply use it in your code by :

<?= $form->field($model, 'time')->widget(\xinyeweb\datetimepicker\Datetimepicker::className(),[
    'phpDatetimeFormat' => 'yyyy-MM-dd',
    'clientOptions' => [
        'minView' => 'month',//只選擇日期
        'language'=> 'zh-CN',
        'format' => 'yyyy-mm-dd',
        'weekStart' => 1,
        'todayBtn' => 1,
        'autoclose' => 1,
        'startDate' => date('Y-m-d'),
        'todayHighlight' => 1,
        'startView' => 2,
        'forceParse' => 0,
        'showMeridian' => 1
    ]
]) ?>

Tips

$('#datetimepicker').datetimepicker({
     value: '',                      // 设置当前datetimepicker的值
     rtl: false,                    // false   默认显示方式   true timepicker和datepicker位置变换
     format:    'Y/m/d H:i',        // 设置时间年月日时分的格式 如: 2016/11/15 18:00
     formatTime:    'H:i',          // 设置时间时分的格式
     formatDate:    'Y/m/d',        // 设置时间年月日的格式
     startDate:    false,           // new Date(), '1986/12/08', '-1970/01/05','-1970/01/05',
     step: 10,                      // 设置时间时分的间隔
     closeOnDateSelect: false,      // true 设置datepicker可点击   false 设置datepicker不可点击 实际上可以双击
     closeOnTimeSelect: true,       // true 设置timepicker可点击   false 设置timepicker不可点击 
     closeOnWithoutClick: true,     // true 设置点击input可以隐藏datetimepicker   false 设置点击input不可以隐藏datetimepicker  
     closeOnInputClick: true,       // true 设置点击input可以隐藏datetimepicker   false 设置点击input不可以隐藏datetimepicker  (会有闪动 先隐藏 再显示)
     timepicker: true,              // true 显示timepicker   false 隐藏timepicker
     datepicker: true,              // true 显示datepicker   false 隐藏datepicker
     weeks: false,                  // true 显示周数   false 隐藏周数
     defaultTime: false,            // 如果输入值为空 可用来设置默认显示时间 use formatTime format (ex. '10:00' for formatTime:    'H:i') 
     defaultDate: false,            // 如果输入值为空 可用来设置默认显示日期 use formatDate format (ex new Date() or '1986/12/08' or '-1970/01/05' or '-1970/01/05')
     minDate: false,                // 设置datepicker最小的限制日期   如：2016/08/15
     maxDate: false,                // 设置datepicker最大的限制日期   如：2016/11/15
     minTime: false,                // 设置timepicker最小的限制时间   如：08:00
     maxTime: false,                // 设置timepicker最大的限制时间   如：18:00
     allowTimes: [],                // 设置timepicker显示的时间   如：allowTimes:['09:00','11:00','12:00','21:00']
     opened: false,                 // false默认打开datetimepicker可关闭  true打开datetimepicker后不可关闭
     initTime: true,                // 设置timepicker默认时间   如：08:00
     inline: false,                 // ture设置datetimepicker一直显示
     theme: '',                     // ture设置datetimepicker显示样式 如: 'dark'
     withoutCopyright: true,        // ture默认隐藏左下角'xdsoft.net'链接  false 显示左下角'xdsoft.net'链接 
     inverseButton: false,          // false 默认   true datepicker的上一月和下一月功能互换  timepicker的上下可点击按钮功能互换
     hours12: false,                // true设置12小时格式  false设置24小时格式
     next: 'xdsoft_next',           // 设置datepicker上一月按钮的样式
     prev : 'xdsoft_prev',          // 设置datepicker下一月按钮的样式
     dayOfWeekStart: 0,             // 设置默认第-列为周几 如：0 周日  1 周一
     parentID: 'body',              // 设置父级选择器
     timeHeightInTimePicker: 25,    // 设置timepicker的行高
     timepickerScrollbar: true,     // ture设置timepicker显示滑动条  false设置timepicker不显示滑动条
     todayButton: true,             // ture显示今天按钮  false不显示今天按钮   位置在datepicker左上角
     prevButton: true,              // ture显示上一月按钮  false不显示上一月按钮   位置在datepicker左上角
     nextButton: true,              // ture显示下一月按钮  false不显示下一月按钮   位置在datepicker又上角
     scrollMonth: true,             // ture 设置datepicker的月份可以滑动  false设置datepicker的月份不可以滑动
     lazyInit: false,               // 翻译： 初始化插件发生只有当用户交互。大大加速插件与大量的领域的工作
     mask: false,                   // 使用输入掩码。真正的-自动生成一个字段的“格式”的面具，从0到9的数字，设置为值的最高可能的数字。例如：第一个小时的数字不能大于2，而第一位数字不能大于5  如：{mask:'9999/19/39 29:59',format:'Y/m/d H:i'}
     validateOnBlur: true,          // 失去焦点时验证datetime值输入,。如果值是无效的datetime,然后插入当前日期时间值
     yearStart: 1950,               // 设置最小的年份   
     yearEnd: 2050,                 // 设置最大的年份
     monthStart: 0,                 // 设置最小的月份
     monthEnd: 11,                  // 设置最大的月份
     roundTime: 'round',            // 设置timepicker的计算方式  round四舍五入 ceil向上取整 floor向下取整
     allowDateRe : null,            // 设置正则表达式检查日期 如：{format:'Y-m-d',allowDateRe:'\d{4}-(03-31|06-30|09-30|12-31)' }
     disabledDates : [],            // 设置不可点击的日期  如：disabledDates: ['21.11.2016','22.11.2016','23.11.2016','24.11.2016','25.11.2016','26.11.2016']
     disabledWeekDays: [],          // 设置不可点击的星期  如：disabledWeekDays:[0,3,4]
     yearOffset: 0,                 // 设置偏移年份  如：2 代表当前年份加2  -2  代表当前年份减2
     beforeShowDay: null,           // 显示datetimepicker之前可调用的方法  {beforeShowDay:function(d) {console.log("bsd"); } }
     enterLikeTab: true,            // tab按键均可使datetimepicker关闭  true点击回车键可使datetimepicker关闭 false点击回车键不可使datetimepicker关闭 
     showApplyButton: false         // 相当于确定按钮  true显示  false隐藏
});

Listener

/*
 *  监听时间插件显示时的事件
 */
$('#datetimepicker').datetimepicker({
    onShow: function(dateText, inst) {
       console.log("---已打开datetimepicker----");
    }
}); 

/*
 *  监听时间插件关闭时的事件 
 */
$('#datetimepicker').datetimepicker({
    onClose: function(dateText, inst) {
       console.log("---已关闭datetimepicker----");
    }
}); 

/*
 *  监听点击日期时的事件
 */
$('#datetimepicker').datetimepicker({
    onSelectDate: function(dateText, inst) {
       console.log(dateText);
    }
}); 

/*
 *  监听点击时分的事件
 */
$('#datetimepicker').datetimepicker({
    onSelectTime: function(dateText, inst) {
       console.log(dateText);
    }
}); 

/*
 *  监听点击datepicker 上一月下一月按钮及选择月份点击事件   
 */
$('#datetimepicker').datetimepicker({
    onChangeMonth: function(dateText, inst) {
       console.log(dateText);
    }
});

/*
 *  监听获取当前datetimepicker显示的所有日期信息
 */
$('#datetimepicker').datetimepicker({
    onGetWeekOfYear: function(dateText, inst) {
       console.log(dateText);
    }
}); 

 /*
 *  监听选择年份的点击事件
 */
$('#datetimepicker').datetimepicker({
    onChangeYear: function(dateText, inst) {
       console.log(dateText);
    }
});

 /*
 *  实时监听你选择的日期和时间
 */
$('#datetimepicker').datetimepicker({
    onChangeDateTime: function(dateText, inst) {
       console.log(dateText);
    }
}); 

 /*
 *  实时监听datetimepicker上的所有事件
 */
$('#datetimepicker').datetimepicker({
    onGenerate: function(dateText, inst) {
       console.log(dateText);
    }
});