基于bootstrap的datetimepicker插件总结

      需求分析：领导要求需要做一个比较简单的表单，主要内容包括姓名、联系方式、出发时间、出发地点等，要求出发时间和出发地点可以自己选择，固定格式。

      问题：没写过时间控件，不知道怎么写，时间涉及到的属性那么多，包括年份、月、日、小时、分等，怎么获取与设置，等。

      解决方法：在网上搜索了很多资料，由于项目中用到了Bootstrap，于是决定用基于bootstrap的datetimepicker插件。那么问题来了，这个咋用呢？

      进入正题。

1、先来看看效果图

      效果感觉还不错，那就来看看这个效果是怎么实现的。

2、简单的应用实例

     首先先把这个实例需要用到的日期控件下载下来，直接在百度上搜索Bootstrap就可以到它的官网下载资源，也可以到这里下载http://www.bootcss.com/p/bootstrap-datetimepicker/。

     这部分所写的代码都是最基本的使用，还没有涉及到其他属性的设置，只是初步完成了效果而已。

     页面里需要的基本文件有：

• bootstrap.min.css（含有bootstrap 所有css）
• bootstrap-datetimepicker.min.css（重要，这就是日期控件所需的样式表）
• jquery-3.1.0.min.js（其他版本的jquery也可以）
• bootstrap.min.js（含有bootstrap 所有js）
• bootstrap-datetimepicker.js（重要，这就是日期控件所需的js）
• locales/bootstrap-datetimepicker.fr.js（重要，这里是日期控件初始值）
• bootstrap-combined.min.css   （这个是可以让样式更丰富，但不是必须的，可以自己选择）
  

     接着写一个基本的结构：

     下面是我的目录结构：

      

    结构代码：

    
        
        
        /*（含有bootstrap 所有css）*/
        
    

　   
       
        这里就写上自己需要的代码，比如你想要的是一个简单的输入框
        时间控件就写输入框的代码，具体如下几种样式介绍
    
    　
    /*（重要，依赖jquery）*/
    /*（含有bootstrap 所有js)*/
    /*（重要，这就是日期控件所需的js）*/
    /*（重要，弹出日历里面 显示的文字 bootstrap里面显示的是英文 ，触发后显示的年月日等的显示文字，即为：Jan，feb等等）*/
　　
    

     现在基本结构写完了，根据不同需求，也有不同的样式写法。

1）最简单的输入框

js:

$('#datetimepicker').datetimepicker();

当然也可以把后面的data-date-format当做属性写在js中，如下：

js:

            $('#datetimepicker').datetimepicker({
                format: 'yyyy-mm-dd hh:ii',      /*此属性是显示顺序，还有显示顺序是mm-dd-yyyy*/
            });

效果（点击之后的效果）：

2）作为组件使用

js:

$('#datetimepicker').datetimepicker();

效果：

3）作为内联日期时间选择器

js：

$('#datetimepicker').datetimepicker();

效果（直接是在页面中显示这个时间控件的内容）：

3、其他的方法和属性

1）format    

     这个是必须要设置的。

     默认值: 'mm/dd/yyyy'

     日期格式， p, P, h, hh, i, ii, s, ss, d, dd, m, mm, M, MM, yy, yyyy 的任意组合。
2）weekStart

     默认值：0一周从哪一天开始。0（星期日）到6（星期六）

3）startDate

     Date。默认值：开始时间
4）endDate

     Date。默认值：结束时间

5）daysOfWeekDisabled  一周禁用的日期

     String，Array。 默认值: '', []
6）autoclose

    Boolean。 默认值：false

    当选择一个日期之后是否立即关闭此日期时间选择器。

7）startView

     Number， String。默认值：2， 'month'。

     日期时间选择器打开之后首先显示的视图。

8）minView

     Number，String. 默认值：0, 'hour'。

     日期时间选择器所能够提供的最精确的时间选择视图。

9）maxView

     Number， String。 默认值：4, 'decade'

     日期时间选择器最高能展示的选择范围视图。

10）todayBtn

     Boolean， "linked"。 默认值： false

     如果此值为true 或 "linked"，则在日期时间选择器组件的底部显示一个 "Today" 按钮用以选择当前日期。如果是true的话，"Today" 按钮仅仅将视图转到当天的日期，如果是"linked"，当天日期将会被选中。

11）todayHighlight

     Boolean。默认值：false。如果为true，高亮当前日期。
12）keyboardNavigationBoolean。

     默认值：true

     是否允许通过方向键改变日期。

13）language

    String。默认值: 'en'

14）forceParse

    Boolean。默认值：true

    当选择器关闭的时候，是否强制解析输入框中的值。也就是说，当用户在输入框中输入了不正确的日期，选择器将会尽量解析输入的值，并将解析后的正确值按照给定的格式format设置到输入框中。

15）minuteStep

    Number。 默认值：5

    此数值被当做步进值用于构建小时视图。对于每个 minuteStep 都会生成一组预设时间（分钟）用于选择。

16）pickerReferer : 不建议使用

    String。默认值：'default' (other value available : 'input')

17）pickerPosition

    String。 默认值：'bottom-right' (还支持 : 'bottom-left')

    此选项当前只在组件实现中提供支持。通过设置选项可以讲选择器放倒输入框下方。

18）viewSelect

    Number or String。 默认值：same as minView (supported values are: 'decade', 'year', 'month', 'day', 'hour')

4、综合例子

    让显示的日期为中文。

    bootstrap-datetimepicker.fr.js/bootstrap-datepicker.zh-CN.js文件中定义了显示的文字，显示中文，需要在设置的时候，把language设为“zh-CN”（datetime.js）。然后引用bootstrap-datepicker.zh-CN.js文件。

    这个文件中的代码如下：

(function($){
    $.fn.datetimepicker.dates['zh-CN'] = {
        days: ["星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期日"],
        daysShort: ["周日", "周一", "周二", "周三", "周四", "周五", "周六", "周日"],
        daysMin:  ["日", "一", "二", "三", "四", "五", "六", "日"],
        months: ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"],
        monthsShort: ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"],
        today: "今日",

        suffix: [],
        meridiem: ["am", "pm"],
        weekStart: 1,

    };
}(jQuery));

      为了更好地演示代码，我直接将这个中文显示的代码写在同一个文件中。