bootstrap3日期選擇器(datepicker)屬性

初次使用映胁,依賴庫以及日期選擇器等下載地址,請在筆者另文查找:bootstrap日期選擇器本地化-中文

這篇說明 bootstrap3 Datepicker 官網(wǎng)的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({
     //...
});

部分設(shè)置相關(guān)屬性即可模蜡。如:

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

屬性列表

1 - format

接收的參數(shù)類型:

Default: 'MMMM YYYY'
Accepts: many types

format 可接受參數(shù)參考 moment.js - Display - Format

① - false [default]

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

③ - 其他日期格式可參考moment網(wǎng)站:moment format

2 - dayViewHeaderFormat

接收的參數(shù)類型:

Default: 'MMMM YYYY'
Accepts: many types

dayViewHeaderFormat 可接受參數(shù)參考 moment.js - Display - Format

① - 'MMMM YYYY'

② - 'dddd MMMM YYYY'

③ - 其他日期格式可參考moment網(wǎng)站: moment.js - Display - Format

3 - extraFormats

接收的參數(shù)類型:

Default: false
Accepts: many types

extraFormats 可接受參數(shù)參考

① - false [default]

4 - stepping 整型

接收的參數(shù)類型:

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

① - 1 [default]

② - 10

③ - 其他自行發(fā)揮想象

5 - minDate

接收的參數(shù)類型:

Default: false
Accepts: date, moment, string

說明:不允許設(shè)置minDate以前的時間迂猴,注意:該方法會重寫defaultDate和useCurrent

① - false [default]

② - moment()
取現(xiàn)在的時間為minDate,在此之前的時間變灰且不可選离唐。

6 - maxDate

接收的參數(shù)類型:

Default: false
Accepts: date, moment, string

說明:不允許設(shè)置maxDate以后的時間病附,注意:該方法會重寫defaultDate和useCurrent

① - false [default]

② - moment()
取現(xiàn)在的時間為maxDate,在此之后的時間變灰且不可選亥鬓。

7 - useCurrent

接收的參數(shù)類型:

Default: true
Accepts: true/false

① - true [default]
點擊彈出選擇器后完沪,文本框獲取并顯示當(dāng)前時間。注意:實際上顯示的是打開瀏覽器時的時間嵌戈,不是當(dāng)前時間覆积。

② - false
點擊彈出選擇器后,文本框不顯示當(dāng)前時間

8 - collapse

接收的參數(shù)類型:

Default: true
Accepts: true/false

① - true [default]

② - false

9 - locale

接收的參數(shù)類型:

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

說明:本地化

① - moment.locale() [default]
默認(rèn)是美國英語熟呛,注意:locale針對的是日期選擇器宽档,而非文本框,文本框通過上文的format設(shè)置

② - moment().locale('zh-cn')
簡體中文

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

④ - 其他國家地區(qū)可以在moment.js下載包中的locale文件中找到對應(yīng)的本地化文件惰拱,下載地址請移步本文開頭的鏈接雌贱。

10 - defaultDate

接收的參數(shù)類型:

Default: false
Accepts: date, moment, string

① - false [default]

11 - disabledDates

接收的參數(shù)類型:

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

① - false [default]

12 - enabledDates

接收的參數(shù)類型:

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

① - false [default]

13 - icons

接收的參數(shù)類型:

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

說明:圖標(biāo)更改

14 - useStrict

接收的參數(shù)類型:

Default: false
Accepts: true/false

① - false [default]

15 - sideBySide

接收的參數(shù)類型:

Default: false
Accepts: true/false

將時間選擇移動到右邊,與日期選擇并排

① - false [default]

② - true

16 - daysOfWeekDisabled

接收的參數(shù)類型:

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

說明:0為周日偿短,1-6為周一-周六

① - [] [default]

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

③ - 其他自行發(fā)揮想象

17 - calendarWeeks

接收的參數(shù)類型:

Default: false
Accepts: true/false 

說明:是否顯示當(dāng)前周是今年的第幾周欣孤,默認(rèn)不顯示

① - false [default]

② - true

18 - viewMode

接收的參數(shù)類型:

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

說明:在初次打開日期選擇器時的顯示模式

① - 'days' [default]

② - 'decades'

③ - 'years'

④ - 'months'

19 - toolbarPlacement

接收的參數(shù)類型:

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

說明:defualt和bottom其實是一樣的

① - 'default' [default]

② - 'top'

20 - showTodayButton

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:顯示"今日按鈕",點擊后自動調(diào)整為當(dāng)前時間昔逗,精確到秒降传,并同步UI。默認(rèn)不顯示

① - false [default]

② - true

21 - showClear

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:顯示"清除按鈕"勾怒,點擊后取消當(dāng)前選取的日期并清空文本框婆排。默認(rèn)不顯示

① - false [default]

② - true

22 - showClose

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:顯示"關(guān)閉按鈕",點擊后關(guān)閉日期選擇器笔链。默認(rèn)不顯示段只。通常不需要,只要點選日期選擇器外的區(qū)域就可實現(xiàn)關(guān)閉鉴扫。

① - false [default]

② - true

23 - widgetPositioning

接收的參數(shù)類型:

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

說明:指定日期選擇器彈出的方向赞枕,默認(rèn)在垂直方向和水平方向都采用自適應(yīng)(auto)。

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

② - {}

24 - widgetParent

接收的參數(shù)類型:

Default: null
Accepts: string or jQuery object

25 - keepOpen

接收的參數(shù)類型:

Default: false
Accepts: true/false

① - false [default]

② - true

26 - inline

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:不使用文本框的日期選擇器

官網(wǎng)代碼例子

<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

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:是否允許文本框鍵入的日期格式無效,不允許時文本框會自動修改成正確的格式炕婶。默認(rèn)不允許姐赡。

28 - keyBinds

接收的參數(shù)類型:

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

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:開啟debug模式后,打開日期選擇器后柠掂,點擊選擇器外的區(qū)域不會關(guān)閉選擇器项滑。默認(rèn)不開啟

30 - ignoreReadonly

接收的參數(shù)類型:

Default: false
Accepts: true/false

31 - disabledTimeIntervals

接收的參數(shù)類型:

Default: false
Accepts: 

32 - allowInputToggle

接收的參數(shù)類型:

Default: false
Accepts: true/false

說明:是否允許點擊文本框彈出日期選擇器。默認(rèn)不允許涯贞。

33 - focusOnShow

接收的參數(shù)類型:

Default: true
Accepts: true/false

說明:點擊打開日期選擇器后枪狂,自動focus文本框。如果沒有focus文本框宋渔,那么點擊日期選擇器外的區(qū)域摘完,不會關(guān)閉選擇器。默認(rèn)focus傻谁。

34 - enabledHours

接收的參數(shù)類型:

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

說明:給出可用小時的數(shù)組。默認(rèn)false——所有小時都可用列粪。注意:為了該邏輯审磁,還需要做以下這些工作:
1 - 設(shè)置useCurrent屬性為false
2 - "今日按鈕"不可見,或可見但添加邏輯判斷當(dāng)前時間是否在enabledHours給出的值范圍內(nèi)岂座。
3 - 在日期選擇器點選一個日期時态蒂,也會選取一個時分秒【見下圖】(如果useCurrent設(shè)置為false,該時間經(jīng)過測試是打開瀏覽器的時間费什,具體是渲染完成前還是完成后暫不得而知钾恢;如果useCurrent設(shè)置為true,要清空文本框內(nèi)的時間鸳址,并重新打開日期選擇器才會重新獲取當(dāng)前時間瘩蚪。),所以也要對其添加邏輯判斷這個時間是否在enabledHours給出的值范圍內(nèi)稿黍。
4 - 想到或遇到時繼續(xù)完善疹瘦,歡迎各位補充

① - false [default]

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

35 - disabledHours

接收的參數(shù)類型:

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

說明:參考enabledHours,不贅述巡球。

36 - viewDate

接收的參數(shù)類型:

Default: false
Accepts: date, moment, string

37 - tooltips

接收的參數(shù)類型:

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是當(dāng)鼠標(biāo)懸停在控件上酣栈,彈出一些提示性文字的工具。如下圖矿筝,當(dāng)懸停在"今日按鈕"約一秒起便,彈出"Go to today"提示文字。對應(yīng)上面的'today'鍵缨睡,修改鍵便可自定義懸停提示文字

tooltips : {today : '當(dāng)前時間'}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市奖年,隨后出現(xiàn)的幾起案子细诸,更是在濱河造成了極大的恐慌陋守,老刑警劉巖水评,帶你破解...
    沈念sama閱讀 219,366評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異寇甸,居然都是意外死亡疗涉,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,521評論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來闹伪,“玉大人偏瓤,你說我怎么就攤上這事⊥匀猓” “怎么了已骇?”我有些...
    開封第一講書人閱讀 165,689評論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長卵渴。 經(jīng)常有香客問我鲤竹,道長昔榴,這世上最難降的妖魔是什么互订? 我笑而不...
    開封第一講書人閱讀 58,925評論 1 295
  • 正文 為了忘掉前任仰禽,我火速辦了婚禮纺蛆,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘温峭。我一直安慰自己字支,他們只是感情好堕伪,可當(dāng)我...
    茶點故事閱讀 67,942評論 6 392
  • 文/花漫 我一把揭開白布刃跛。 她就那樣靜靜地躺著苛萎,像睡著了一般。 火紅的嫁衣襯著肌膚如雪蛙酪。 梳的紋絲不亂的頭發(fā)上翘盖,一...
    開封第一講書人閱讀 51,727評論 1 305
  • 那天馍驯,我揣著相機與錄音汰瘫,去河邊找鬼。 笑死趴乡,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的蒿涎。 我是一名探鬼主播惦辛,決...
    沈念sama閱讀 40,447評論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼裙品,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了岁忘?” 一聲冷哼從身側(cè)響起干像,我...
    開封第一講書人閱讀 39,349評論 0 276
  • 序言:老撾萬榮一對情侶失蹤麻汰,失蹤者是張志新(化名)和其女友劉穎五鲫,沒想到半個月后岔擂,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體乱灵,經(jīng)...
    沈念sama閱讀 45,820評論 1 317
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,990評論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了蝉稳。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片耘戚。...
    茶點故事閱讀 40,127評論 1 351
  • 序言:一個原本活蹦亂跳的男人離奇死亡毕莱,死狀恐怖颅夺,靈堂內(nèi)的尸體忽然破棺而出蛹稍,到底是詐尸還是另有隱情唆姐,我是刑警寧澤,帶...
    沈念sama閱讀 35,812評論 5 346
  • 正文 年R本政府宣布赵抢,位于F島的核電站烦却,受9級特大地震影響先巴,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜摩渺,卻給世界環(huán)境...
    茶點故事閱讀 41,471評論 3 331
  • 文/蒙蒙 一摇幻、第九天 我趴在偏房一處隱蔽的房頂上張望挥萌。 院中可真熱鬧瑞眼,春花似錦棵逊、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,017評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽次慢。三九已至,卻和暖如春劈愚,著一層夾襖步出監(jiān)牢的瞬間菌羽,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,142評論 1 272
  • 我被黑心中介騙來泰國打工猾蒂, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留肚菠,地道東北人署鸡。 一個月前我還...
    沈念sama閱讀 48,388評論 3 373
  • 正文 我出身青樓靴庆,卻偏偏與公主長得像,于是被迫代替她去往敵國和親奢讨。 傳聞我的和親對象是個殘疾皇子焰薄,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,066評論 2 355

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理亩码,服務(wù)發(fā)現(xiàn)野瘦,斷路器,智...
    卡卡羅2017閱讀 134,667評論 18 139
  • 國家電網(wǎng)公司企業(yè)標(biāo)準(zhǔn)(Q/GDW)- 面向?qū)ο蟮挠秒娦畔?shù)據(jù)交換協(xié)議 - 報批稿:20170802 前言: 排版 ...
    庭說閱讀 10,989評論 6 13
  • 一、EL表達(dá)式簡介 1.EL全名為Expression Language席覆。主要作用: 獲取數(shù)據(jù):EL表達(dá)式主要用于...
    yjaal閱讀 3,907評論 2 28
  • 中文翻譯 ng help ng build 構(gòu)建您的應(yīng)用程序并將其放入輸出路徑(dist /默認(rèn)情況下)佩伤。 別名:...
    4ea0af17fd67閱讀 2,035評論 0 0
  • 我曾經(jīng)用三個月作死了一個團隊障斋,在那之后的一個月里垃环,我沉浸在挫敗感里走不出來。等冷靜下來之后寥院,我重新梳理了這段經(jīng)歷涛目,...
    清非閱讀 297評論 0 4