基于bootstrap的datetimepicker插件总结

Posted Wendy-lxq

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了基于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   (这个是可以让样式更丰富,但不是必须的,可以自己选择)
     接着写一个基本的结构:      下面是我的目录结构:

      

    结构代码:

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>基于bootstrap的datetimepicker插件</title>
        <link href="../css/bootstrap.min.css" rel="stylesheet" />/*(含有bootstrap 所有css)*/
        <link href="../css/bootstrap-datetimepicker.min.css" rel="stylesheet" />
    </head>
<body>
    <div>       
        这里就写上自己需要的代码,比如你想要的是一个简单的输入框
        时间控件就写输入框的代码,具体如下几种样式介绍
    </div>
     
    <script type="text/javascript" src="../js/jquery.3.1.0.min.js"></script>/*(重要,依赖jquery)*/
    <script type="text/javascript" src="../js/bootstrap.min.js"></script>/*(含有bootstrap 所有js)*/
    <script type="text/javascript" src="../js/bootstrap-datetimepicker.js"></script>/*(重要,这就是日期控件所需的js)*/
    <script type="text/javascript" src="../js/locales/bootstrap-datetimepicker.fr.js"></script>/*(重要,弹出日历里面 显示的文字 bootstrap里面显示的是英文 ,触发后显示的年月日等的显示文字,即为:Jan,feb等等)*/
  
    <script type="text/javascript">
        这里写自己的js,调用时间选择器,也就是激活日期选择器,即为下文的js
    </script>
</body>
</html>
     现在基本结构写完了,根据不同需求,也有不同的样式写法。

1)最简单的输入框

<input type="text" value="2017-07-31 17:58" id="datetimepicker"  class="form_datetime" data-date-format="yyyy-mm-dd hh:ii">
js:
$('#datetimepicker').datetimepicker();

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

<input type="text" value="2017-07-31 21:05" id="datetimepicker">
js:
            $('#datetimepicker').datetimepicker(
                format: 'yyyy-mm-dd hh:ii',      /*此属性是显示顺序,还有显示顺序是mm-dd-yyyy*/
            );
效果(点击之后的效果):


2)作为组件使用

    <!--作为组件使用-->
    <div class="input-append date" id="datetimepicker" data-date="31-07-2017" data-date-format="dd-mm-yyyy">
        <input size="16" type="text" value="31-07-2017" readonly>
        <span class="add-on"><i data-date-icon="icon-calendar" class="icon-calendar"></i></span>
    </div>
js:
$('#datetimepicker').datetimepicker();
效果:


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

<div id="datetimepicker"></div>
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));
      为了更好地演示代码,我直接将这个中文显示的代码写在同一个文件中。
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <link rel="stylesheet" href="../css/bootstrap.min.css" type="text/css">
    <link rel="stylesheet" href="../css/bootstrap-combined.min.css" type="text/css">
    <link rel="stylesheet" href="../css/bootstrap-datetimepicker.min.css" type="text/css">
    <script src="../js/jquery-3.1.0.min.js" type="text/javascript" language="utf-8"></script>
    <script src="../js/bootstrap.min.js" type="text/javascript" language="utf-8"></script>
    <script src="../js/bootstrap-datetimepicker.min.js" type="text/javascript" language="utf-8"></script>
    <title>Title</title>
    <script>
        $(function()
            $.fn.datetimepicker.dates['zh-CN'] = 
                days: ["星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期日"],
                daysShort: ["周日", "周一", "周二", "周三", "周四", "周五", "周六", "周日"],
                daysMin:  ["日", "一", "二", "三", "四", "五", "六", "日"],
                months: ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"],
                monthsShort: ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"],
                today: "今日",
                suffix: [],
                meridiem: ["上午", "下午"],
                weekStart: 1
            ;

            $('#datetimepicker').datetimepicker(
                language:"zh-CN",
                todayHighlight: true,
                minView:2,//最精准的时间选择为日期0-分 1-时 2-日 3-月
                weekStart:1
            );

        );

    </script>
</head>
<body>
<div class="box">
    <!--作为内联日期时间选择器-->
    <div id="datetimepicker"></div>
</div>
</body>
</html>


以上是关于基于bootstrap的datetimepicker插件总结的主要内容,如果未能解决你的问题,请参考以下文章

Bootstrap 3 datetimepicker 事件未触发

bootstrap-datetimepicker时间插件使用

bootstrap datetimepicker兼容ie8

bootstrap 4 datetimepicker如何本地化

bootstrap中的日期插件datetimepicker,怎么设置让它只到年月日

Bootstrap 3 datetimepicker - MinTime 和 MaxTime