目錄

  • datetimepicker用法總結
  • 目錄
  • 簡述
  • 官方文檔
  • 選項屬性
  • 1 format 格式
  • 2 weekStart 一週從哪一天開始
  • 3 startDate 開始時間
  • 4 endDate 結束時間
  • 5 daysOfWeekDisabled 一週的周幾不能選
  • 6 autoclose 選完時間後是否自動關閉
  • 7 startView 選完時間首先顯示的視圖
  • 8 minView 最精確的時間
  • 9 maxView 最高能展示的時間
  • 10 todayBtn 當天日期按鈕
  • 11 todayHighlight 當天日期高亮
  • 12 keyboardNavigation 方向鍵改變日期
  • 13 language 語言
  • 14 forceParse 強制解析
  • 15 minuteStep 步進值
  • 16 pickerPosition 選擇框位置
  • 17 showMeridian 是否顯示上下午
  • 18 initialDate 初始化日期時間

1. 簡述

最近因為項目,在用Bootsrapt寫一些前台,遇到datetimepicker時,在使用方面出現了一些問題,索性記錄下來,能用到看看,用不到留着自己參考。

2. 官方文檔

附上官方文檔鏈接,需要的人們傳送門。

官方文檔大部分都是中文,已經不錯了,但是還是在很多問題上沒有給出例子。博主,把一些常用的在後文附上,有錯誤請不吝賜教。

3. 選項(屬性)

總體調用格式為: 
jsp中:

<input type="text" id="demo" >
  • 1
  • 1

js中:

$("#demo").datetimepicker();
  • 1
  • 1

3.1 format — 格式

String類型 
默認值: ‘mm/dd/yyyy’ 
這個是最重要最常用的屬性之一了。控制顯示格式就是固定值得個性化搭配。 
比如,顯示 2016-04-21 19:21

  1.  
    $("#demo").datetimepicker({
  2.  
    format:'yyyy-mm-dd hh:ii'
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

又比如,你就是喜歡反人類的格式,那你可以這樣:

  1.  
    $("#demo").datetimepicker({
  2.  
    format:'hh-yyyy-ii mm:dd'
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

這個是扯淡的,就是個意思,你可以自己設計樣式,但是裏面的字母都代表不同屬性:

符號

意義

p

12小時制且小寫(‘am’ or ‘pm’)

P

12小時制且大寫(‘AM’ or ‘PM’)

s

秒,前面不補0

ss

秒,前面補0

i

分,前面不補0

ii

分,前面補0

h

時,24小時制,前面不補0

hh

時,24小時制,前面補0

H

時,12小時制,前面不補0

HH

時,12小時制,前面補0

d

日,前面不補0

dd

日,前面補0

m

月,數字表示,前面不補0 如:4

mm

月,數字表示,前面補0 如:04

M

月,縮寫表示,前面補0 如:Apr

MM

月,全稱表示,前面補0 如:April

yy

年,後兩位 如:16

yyyy

年,全部 如:2016

3.2 weekStart — 一週從哪一天開始

Integer類型 
默認值:0 
0(星期日)到6(星期六) 
例如:

  1.  
    $("#demo").datetimepicker({
  2.  
    weekStart:3
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

效果: 

viewdesign DatePicker時間格式化_默認值

3.3 startDate — 開始時間

Date類型 
默認值:開始時間

之前的日期都不能選擇,這個時間之後的時間才能選擇。

咱們做一個常用的Demo,就是隻能選現在之後的時間:

例如:

  1.  
    var date = new Date();
  2.  
    $("#demo").datetimepicker({
  3.  
    date
  4.  
    });
  • 1
  • 2
  • 3
  • 4
  • 1
  • 2
  • 3
  • 4

效果卡件上圖中的灰色部分: 

viewdesign DatePicker時間格式化_日期時間_02

3.4 endDate— 結束時間

Date類型 
默認值:結束時間

這個時間後面的不能再選擇。 
用法同上,不再贅述。

3.5 daysOfWeekDisabled — 一週的周幾不能選

String, Array類型 
默認值:”, []

0(星期日)到6(星期六) 
可以有多個。

例如:

  1.  
    $("#demo").datetimepicker({
  2.  
    daysOfWeekDisabled:0,4,6]
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

或者:

  1.  
    $("#demo").datetimepicker({
  2.  
    daysOfWeekDisabled:'0,4,6'
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

效果: 

viewdesign DatePicker時間格式化_默認值_03

3.6 autoclose — 選完時間後是否自動關閉

Boolean類型 
默認值:false

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

3.7 startView — 選完時間首先顯示的視圖

Number, String類型 
默認值:2, ‘month’

日期時間選擇器打開之後首先顯示的視圖。

可接受的值:


意義

0

從小時視圖開始,選分

1

從天視圖開始,選小時

2

從月視圖開始,選天

3

從年視圖開始,選月

4

從十年視圖開始,選年

3.8 minView — 最精確的時間

Number, String類型 
默認值:0, ‘hour’

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

可接受的值:


意義

0

從小時視圖開始,選分

1

從天視圖開始,選小時

2

從月視圖開始,選天

3

從年視圖開始,選月

4

從十年視圖開始,選年

例如:

  1.  
    $("#demo").datetimepicker({
  2.  
    minView :2
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

上例中選完日後,不在出現下級時間選擇。

3.9 maxView — 最高能展示的時間

Number, String類型 
默認值:4, ‘decade’

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

用法同上,不在贅述。

3.10 todayBtn — 當天日期按鈕

Boolean, “linked”類型 
默認值:false’

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

例如:

  1.  
    $("#demo").datetimepicker({
  2.  
    todayBtn : true
  3.  
    });
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

效果: 

viewdesign DatePicker時間格式化_默認值_04

3.11 todayHighlight — 當天日期高亮

Boolean類型 
默認值:false

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

不再舉例。

3.12 keyboardNavigation — 方向鍵改變日期

Boolean類型 
默認值:false

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

不再舉例。

3.13 language — 語言

String類型 
默認值:’en’

中文:’zh-CN’

3.14 forceParse — 強制解析

Boolean類型 
默認值:true

就是你輸入的可能不正規,但是它胡強制儘量解析成你規定的格式(format)

3.15 minuteStep — 步進值

Number類型 
默認值:5

此數值被當做步進值用於構建小時視圖。就是最小的視圖是每5分鐘可選一次。是以分鐘為單位的。

3.16 pickerPosition — 選擇框位置

String類型 
默認值:’bottom-right’

還支持 : ‘bottom-left’,’top-right’,’top-left’

可以試試看,他拿出位置會發生變化。

3.17 showMeridian — 是否顯示上下午

Boolean類型 
默認值:false

在日期和小時選擇界面,出現上下午的選項

3.18 initialDate — 初始化日期時間

Date or String類型 
默認值:new Date()

在打開時默認選當時的時間,顯示在View中。