bootstrap3日期选择器(datepicker)属性

初次使用,依赖库以及日期选择器等下载地址,请在笔者另文查找:bootstrap日期选择器本地化-中文

这篇说明 bootstrap3 Datepicker 官网的Options--属性

一段简单的bootstrap3日期选择器代码

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Bootstrap3 datetime picker Template</title>

    <link href="css/bootstrap.min.css" rel="stylesheet">
    <link href="css/bootstrap-datetimepicker.min.css" rel="stylesheet">

</head>
<body>

<div class="container">
    <div class="row">
        <div class='col-sm-6'>
            <div class="form-group">
                <div class='input-group date' id='datetimepicker1'>
                    <input type='text' class="form-control" />
                    <span class="input-group-addon">
                        <span class="glyphicon glyphicon-calendar"></span>
                    </span>
                </div>
            </div>
        </div>
    </div>
</div>

<script src="js/jquery-2.1.1.min.js"></script>
<script src="js/moment-with-locales.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script src="js/bootstrap-datetimepicker.min.js"></script>
<script>
    $('#datetimepicker1').datetimepicker({
            //...
    });
</script>
</body>
</html>

属性使用十分简单,只需要在上面代码的

$('#datetimepicker1').datetimepicker({
     //...
});

部分设置相关属性即可。如:

$('#datetimepicker1').datetimepicker({
     format : 'dddd YYYY年MM月DD日 HH:mm:ss'
});

属性列表

1 - format

接收的参数类型:

Default: 'MMMM YYYY'
Accepts: many types

format 可接受参数参考 moment.js - Display - Format

① - false [default]

② - 'YYYY年MM月DD日 hh:mm:ss'

③ - 其他日期格式可参考moment网站:moment format

2 - dayViewHeaderFormat

接收的参数类型:

Default: 'MMMM YYYY'
Accepts: many types

dayViewHeaderFormat 可接受参数参考 moment.js - Display - Format

① - 'MMMM YYYY'

② - 'dddd MMMM YYYY'

③ - 其他日期格式可参考moment网站: moment.js - Display - Format

3 - extraFormats

接收的参数类型:

Default: false
Accepts: many types

extraFormats 可接受参数参考

① - false [default]

4 - stepping 整型

接收的参数类型:

Default: 1
Accepts: 1 - n (n can be a large number if you want)

① - 1 [default]

② - 10

③ - 其他自行发挥想象

5 - minDate

接收的参数类型:

Default: false
Accepts: date, moment, string

说明:不允许设置minDate以前的时间,注意:该方法会重写defaultDate和useCurrent

① - false [default]

② - moment()
取现在的时间为minDate,在此之前的时间变灰且不可选。

6 - maxDate

接收的参数类型:

Default: false
Accepts: date, moment, string

说明:不允许设置maxDate以后的时间,注意:该方法会重写defaultDate和useCurrent

① - false [default]

② - moment()
取现在的时间为maxDate,在此之后的时间变灰且不可选。

7 - useCurrent

接收的参数类型:

Default: true
Accepts: true/false

① - true [default]
点击弹出选择器后,文本框获取并显示当前时间。注意:实际上显示的是打开浏览器时的时间,不是当前时间。

② - false
点击弹出选择器后,文本框不显示当前时间

8 - collapse

接收的参数类型:

Default: true
Accepts: true/false

① - true [default]

② - false

9 - locale

接收的参数类型:

Default: moment.locale()
Accepts: string, moment.local('locale')

说明:本地化

① - moment.locale() [default]
默认是美国英语,注意:locale针对的是日期选择器,而非文本框,文本框通过上文的format设置

② - moment().locale('zh-cn')
简体中文

③ - moment().locale('fr')
法文

④ - 其他国家地区可以在moment.js下载包中的locale文件中找到对应的本地化文件,下载地址请移步本文开头的链接。

10 - defaultDate

接收的参数类型:

Default: false
Accepts: date, moment, string

① - false [default]

11 - disabledDates

接收的参数类型:

Default: false
Accepts: array of [date, moment, string]

① - false [default]

12 - enabledDates

接收的参数类型:

Default: false
Accepts: array of [date, moment, string]

① - false [default]

13 - icons

接收的参数类型:

Default: {
            time: 'glyphicon glyphicon-time',
            date: 'glyphicon glyphicon-calendar',
            up: 'glyphicon glyphicon-chevron-up',
            down: 'glyphicon glyphicon-chevron-down',
            previous: 'glyphicon glyphicon-chevron-left',
            next: 'glyphicon glyphicon-chevron-right',
            today: 'glyphicon glyphicon-screenshot',
            clear: 'glyphicon glyphicon-trash',
            close: 'glyphicon glyphicon-remove'
        }
Accepts: object with all or some of the parameters above

说明:图标更改

14 - useStrict

接收的参数类型:

Default: false
Accepts: true/false

① - false [default]

15 - sideBySide

接收的参数类型:

Default: false
Accepts: true/false

将时间选择移动到右边,与日期选择并排

① - false [default]

② - true

16 - daysOfWeekDisabled

接收的参数类型:

Default: []
Accepts: array of numbers from 0-6

说明:0为周日,1-6为周一-周六

① - [] [default]

② - [0, 6]
禁用周六日

③ - 其他自行发挥想象

17 - calendarWeeks

接收的参数类型:

Default: false
Accepts: true/false 

说明:是否显示当前周是今年的第几周,默认不显示

① - false [default]

② - true

18 - viewMode

接收的参数类型:

Default: 'days'
Accepts: 'decades','years','months','days'

说明:在初次打开日期选择器时的显示模式

① - 'days' [default]

② - 'decades'

③ - 'years'

④ - 'months'

19 - toolbarPlacement

接收的参数类型:

Default: 'default'
Accepts: 'default', 'top', 'bottom'

说明:defualt和bottom其实是一样的

① - 'default' [default]

② - 'top'

20 - showTodayButton

接收的参数类型:

Default: false
Accepts: true/false

说明:显示"今日按钮",点击后自动调整为当前时间,精确到秒,并同步UI。默认不显示

① - false [default]

② - true

21 - showClear

接收的参数类型:

Default: false
Accepts: true/false

说明:显示"清除按钮",点击后取消当前选取的日期并清空文本框。默认不显示

① - false [default]

② - true

22 - showClose

接收的参数类型:

Default: false
Accepts: true/false

说明:显示"关闭按钮",点击后关闭日期选择器。默认不显示。通常不需要,只要点选日期选择器外的区域就可实现关闭。

① - false [default]

② - true

23 - widgetPositioning

接收的参数类型:

Default: {
            horizontal: 'auto'
            vertical: 'auto'
         }
Accepts: object with the all or one of the parameters above
         horizontal: 'auto', 'left', 'right'
         vertical: 'auto', 'top', 'bottom'

说明:指定日期选择器弹出的方向,默认在垂直方向和水平方向都采用自适应(auto)。

① - {horizontal : 'auto' vertical: 'auto'} [default]

② - {}

24 - widgetParent

接收的参数类型:

Default: null
Accepts: string or jQuery object

25 - keepOpen

接收的参数类型:

Default: false
Accepts: true/false

① - false [default]

② - true

26 - inline

接收的参数类型:

Default: false
Accepts: true/false

说明:不使用文本框的日期选择器

官网代码例子

<div style="overflow:hidden;">
    <div class="form-group">
        <div class="row">
            <div class="col-md-8">
                <div id="datetimepicker12"></div>
            </div>
        </div>
    </div>
    <script type="text/javascript">
        $(function () {
            $('#datetimepicker12').datetimepicker({
                inline: true,
                sideBySide: true
            });
        });
    </script>
</div>

27 - keepInvalid

接收的参数类型:

Default: false
Accepts: true/false

说明:是否允许文本框键入的日期格式无效,不允许时文本框会自动修改成正确的格式。默认不允许。

28 - keyBinds

接收的参数类型:

Default: up: function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().subtract(7, 'd'));
            } else {
                this.date(this.date().clone().add(1, 'm'));
            }
        },
        down: function (widget) {
            if (!widget) {
                this.show();
            }
            else if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().add(7, 'd'));
            } else {
                this.date(this.date().clone().subtract(1, 'm'));
            }
        },
        'control up': function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().subtract(1, 'y'));
            } else {
                this.date(this.date().clone().add(1, 'h'));
            }
        },
        'control down': function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().add(1, 'y'));
            } else {
                this.date(this.date().clone().subtract(1, 'h'));
            }
        },
        left: function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().subtract(1, 'd'));
            }
        },
        right: function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().add(1, 'd'));
            }
        },
        pageUp: function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().subtract(1, 'M'));
            }
        },
        pageDown: function (widget) {
            if (widget.find('.datepicker').is(':visible')) {
                this.date(this.date().clone().add(1, 'M'));
            }
        },
        enter: function () {
            this.hide();
        },
        escape: function () {
            this.hide();
        },
        'control space': function (widget) {
            if (widget.find('.timepicker').is(':visible')) {
                widget.find('.btn[data-action="togglePeriod"]').click();
            }
        },
        t: function () {
            this.date(moment());
        },
        'delete': function () {
            this.clear();
        }

说明:自定义绑定键盘事件

29 - debug

接收的参数类型:

Default: false
Accepts: true/false

说明:开启debug模式后,打开日期选择器后,点击选择器外的区域不会关闭选择器。默认不开启

30 - ignoreReadonly

接收的参数类型:

Default: false
Accepts: true/false

31 - disabledTimeIntervals

接收的参数类型:

Default: false
Accepts: 

32 - allowInputToggle

接收的参数类型:

Default: false
Accepts: true/false

说明:是否允许点击文本框弹出日期选择器。默认不允许。

33 - focusOnShow

接收的参数类型:

Default: true
Accepts: true/false

说明:点击打开日期选择器后,自动focus文本框。如果没有focus文本框,那么点击日期选择器外的区域,不会关闭选择器。默认focus。

34 - enabledHours

接收的参数类型:

Default: false
Accepts: array of numbers from 0-23 (0-11 if using am/pm)

说明:给出可用小时的数组。默认false——所有小时都可用。注意:为了该逻辑,还需要做以下这些工作:
1 - 设置useCurrent属性为false
2 - "今日按钮"不可见,或可见但添加逻辑判断当前时间是否在enabledHours给出的值范围内。
3 - 在日期选择器点选一个日期时,也会选取一个时分秒【见下图】(如果useCurrent设置为false,该时间经过测试是打开浏览器的时间,具体是渲染完成前还是完成后暂不得而知;如果useCurrent设置为true,要清空文本框内的时间,并重新打开日期选择器才会重新获取当前时间。),所以也要对其添加逻辑判断这个时间是否在enabledHours给出的值范围内。
4 - 想到或遇到时继续完善,欢迎各位补充

① - false [default]

② - [0, 1]
0时和1时可用

35 - disabledHours

接收的参数类型:

Default: false
Accepts: array of numbers from 0-23 (0-11 if using am/pm)

说明:参考enabledHours,不赘述。

36 - viewDate

接收的参数类型:

Default: false
Accepts: date, moment, string

37 - tooltips

接收的参数类型:

tooltips: {
    today: 'Go to today',
    clear: 'Clear selection',
    close: 'Close the picker',
    selectMonth: 'Select Month',
    prevMonth: 'Previous Month',
    nextMonth: 'Next Month',
    selectYear: 'Select Year',
    prevYear: 'Previous Year',
    nextYear: 'Next Year',
    selectDecade: 'Select Decade',
    prevDecade: 'Previous Decade',
    nextDecade: 'Next Decade',
    prevCentury: 'Previous Century',
    nextCentury: 'Next Century',
    incrementHour: 'Increment Hour',
    pickHour: 'Pick Hour',
    decrementHour:'Decrement Hour',
    incrementMinute: 'Increment Minute',
    pickMinute: 'Pick Minute',
    decrementMinute:'Decrement Minute',
    incrementSecond: 'Increment Second',
    pickSecond: 'Pick Second',
    decrementSecond:'Decrement Second',
}

说明:tooltips是当鼠标悬停在控件上,弹出一些提示性文字的工具。如下图,当悬停在"今日按钮"约一秒,弹出"Go to today"提示文字。对应上面的'today'键,修改键便可自定义悬停提示文字

tooltips : {today : '当前时间'}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,014评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,796评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,484评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,830评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,946评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,114评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,182评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,927评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,369评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,678评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,832评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,533评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,166评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,885评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,128评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,659评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,738评论 2 351

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,639评论 18 139
  • 国家电网公司企业标准(Q/GDW)- 面向对象的用电信息数据交换协议 - 报批稿:20170802 前言: 排版 ...
    庭说阅读 10,934评论 6 13
  • 一、EL表达式简介 1.EL全名为Expression Language。主要作用: 获取数据:EL表达式主要用于...
    yjaal阅读 3,839评论 2 28
  • 中文翻译 ng help ng build 构建您的应用程序并将其放入输出路径(dist /默认情况下)。 别名:...
    4ea0af17fd67阅读 2,022评论 0 0
  • 我曾经用三个月作死了一个团队,在那之后的一个月里,我沉浸在挫败感里走不出来。等冷静下来之后,我重新梳理了这段经历,...
    清非阅读 294评论 0 4