bootstrap-datetimepicker時間控制元件

阿新 • • 發佈：2018-11-13

官網

頁面裡需要的檔案有：

bootstrap.min.css（含有bootstrap 所有css）

bootstrap-datetimepicker.min.css（重要，這就是日期控制元件所需的樣式表）

jquery-1.8.3.min.js（其他版本的jquery也可以）

bootstrap.min.js（含有bootstrap 所有js）

bootstrap-datetimepicker.js（重要，這就是日期控制元件所需的js）

locales/bootstrap-datetimepicker.fr.js（重要，這裡是日期控制元件初始值）

html頁面是這樣滴~

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>標題</title>
        <meta name="description" content="" />
        <meta name="author" content="" />
        < 
link href="bootstrap.min.css" rel="stylesheet" />/*（含有bootstrap 所有css）*/
        <link href="bootstrap-datetimepicker.min.css" rel="stylesheet" />/*（重要，這就是日期控制元件所需的樣式表）*/
    </head>
    <body>
　   <div>這裡就寫上自己需要的程式碼，比如你想要的是一個簡單的輸入框時間控制元件就寫輸入框的程式碼，具體如下幾種樣式介紹</div>　
    <script  
type="text/javascript" src="jquery.js"></script>/*（重要，依賴jquery）*/
    <script type="text/javascript" src="bootstrap.min.js"></script>/*（含有bootstrap 所有js)*/
    <script type="text/javascript" src="bootstrap-datetimepicker.js"></script>/*（重要，這就是日期控制元件所需的js）*/
    <script type="text/javascript" src="locales/bootstrap-datetimepicker.fr.js"></script>/*（重要，彈出日曆裡面 顯示的文字 
       bootstrap裡面顯示的是英文 ，觸發後顯示的年月日等的顯示文字，即為：Jan，feb等等）*/
　　<script type="text/javascript">這裡寫自己的js，呼叫時間選擇器，也就是啟用日期選擇器，即為下文的js</script>
    </body>

檔案引用完了，咱們就開始設定日期控制元件了。

這裡根據不同需求，也有不同的樣式寫法

第一種是最簡單的輸入框

程式碼：

<input type="text" value="2014-09-23 23:05" id="datetimepicker">

js：

$('#datetimepicker').datetimepicker({
format: 'yyyy-mm-dd hh:ii'      /*此屬性是顯示順序，還有顯示順序是mm-dd-yyyy*/
});

也有這麼寫的

程式碼：

<input type="text" value="2012-05-15 21:05" id="datetimepicker" data-date-format="yyyy-mm-dd hh:ii">

js：

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

作為元件使用的時候

程式碼是這樣的

<div class="input-append date" id="datetimepicker" data-date="12-02-2012" data-date-format="dd-mm-yyyy">
       <input size="16" type="text" value="12-02-2012" readonly>
       <span class="add-on"><i class="icon-th"></i></span>
</div>

js：

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

作為內聯日期時間選擇器：

程式碼是這樣的：

<div id="datetimepicker"></div>

js：

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

以上的介紹中，js部分是一定要寫在頁面裡的，注意要寫在頁面最後面。（js依賴於jquery和bootstrap等檔案）

看到上文出現的藍色文字了沒？沒看到？！好吧，再寫一遍

$('#datetimepicker').datetimepicker({
   format: 'yyyy-mm-dd hh:ii'      /*此屬性是顯示順序，還有顯示順序是mm-dd-yyyy*/
});

看見了吧~裡面的format是什麼東東呢？這就是日期選擇器的引數。有什麼用呢？這是用來設定日期選擇器的一些屬性的。比如我想設定自己想要的時間控制元件。我希望點選選擇的時候先顯示月份而不是年份，我想要時間的順序是dd-mm-yyyy，這個時候就需要引數來設定了。下面就來具體看看一些引數設定吧。

format

這個是必須要設定的。

String. 預設值: 'mm/dd/yyyy'

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

weekStart

Integer. 預設值：0

一週從哪一天開始。0（星期日）到6（星期六）

startDate

Date. 預設值：開始時間

The earliest date that may be selected; all earlier dates will be disabled.

endDate

Date. 預設值：結束時間

The latest date that may be selected; all later dates will be disabled.

daysOfWeekDisabled 一週禁用的日期

String, Array. 預設值: '', []

Days of the week that should be disabled. Values are 0 (Sunday) to 6 (Saturday). Multiple values should be comma-separated. Example: disable weekends: '0,6' or [0,6].

autoclose

Boolean. 預設值：false

當選擇一個日期之後是否立即關閉此日期時間選擇器。

startView

Number, String. 預設值：2, 'month'

日期時間選擇器開啟之後首先顯示的檢視。可接受的值：

0 or 'hour' for the hour view
1 or 'day' for the day view
2 or 'month' for month view (the default)
3 or 'year' for the 12-month overview
4 or 'decade' for the 10-year overview. Useful for date-of-birth datetimepickers.

minView

Number, String. 預設值：0, 'hour'

日期時間選擇器所能夠提供的最精確的時間選擇檢視。

maxView

Number, String. 預設值：4, 'decade'

日期時間選擇器最高能展示的選擇範圍檢視。

todayBtn

Boolean, "linked". 預設值: false

如果此值為true 或 "linked"，則在日期時間選擇器元件的底部顯示一個 "Today" 按鈕用以選擇當前日期。如果是true的話，"Today" 按鈕僅僅將檢視轉到當天的日期，如果是"linked"，當天日期將會被選中。

todayHighlight

Boolean. 預設值: false

如果為true, 高亮當前日期。

keyboardNavigation

Boolean. 預設值: true

是否允許通過方向鍵改變日期。

language

String. 預設值: 'en'

The two-letter code of the language to use for month and day names. These will also be used as the input's value (and subsequently sent to the server in the case of form submissions). Currently ships with English ('en'), German ('de'), Brazilian ('br'), and Spanish ('es') translations, but others can be added (see I18N below). If an unknown language code is given, English will be used.

forceParse

Boolean. 預設值: true

當選擇器關閉的時候，是否強制解析輸入框中的值。也就是說，當用戶在輸入框中輸入了不正確的日期，選擇器將會盡量解析輸入的值，並將解析後的正確值按照給定的格式format設定到輸入框中。

minuteStep

Number. 預設值: 5

此數值被當做步進值用於構建小時檢視。對於每個 minuteStep 都會生成一組預設時間（分鐘）用於選擇。

pickerReferer : 不建議使用

String. 預設值: 'default' (other value available : 'input')

The referer element to place the picker for the component implementation. If you want to place the picker just under the input field, just specify input.

pickerPosition

String. 預設值: 'bottom-right' (還支援 : 'bottom-left')

此選項當前只在元件實現中提供支援。通過設定選項可以講選擇器放倒輸入框下方。

viewSelect

Number or String. 預設值: same as minView (supported values are: 'decade', 'year', 'month', 'day', 'hour')

With this option you can select the view from which the date will be selected. By default it's the last one, however you can choose the first one, so at each click the date will be updated.

showMeridian