使用以下語法,我們就可以創建一個日期選擇輸入元件
html
<input type="text" class="timepicker">
javascript
$(".timepicker").datetimepicker({
changeYear:true,
changeMonth:true,
dateFormat: 'yy-mm-dd',
timeFormat: 'HH:mm'// 時間隔式
});
參數設定:
altField:一個input元素 ,使用選擇器 選擇的另一個地方更新datepicker選擇的日期. 使用 altFormat 指定的這一區域設置如下改變格式的日期(使用input最直觀). 如果沒有代替的區域則使用空白.
altFormat:dateFormat 被 altField 項所使用。 它的目的是允許選擇一種日期格式顯示給使用者以供選擇,而實際的格式則是來自後臺。 對於可能的格式的完整清單,請參閱 formatDate 函數。
appendText:顯示每個日期欄位後面的文本, 例如,以顯示所需的格式。
autoSize:如果設置為true,將自動調整輸入欄位,以適應日期在當前的dateFormat。
beforeShow:一個函數,它接受一個輸入欄位和當前的datepicker實例, 並返回一個選項物件來修改datepicker。只在datepicker顯示之前被調用。
beforeShowDay:一個函數,它接受一個日期作為參數 並且 必須返回一個陣列:
buttonImage:當showOn選項設置為”button”或”both”時, 用於顯示datepicker的圖片url位址。 如果設置,buttonText選項將成為alt值,而不是直接顯示。
buttonImageOnly:無論是按鈕 圖像 必須自行提供 而不是 裡面一個按鈕元素。 此選項僅當buttonImage選項也被設置時才起作用。
buttonText:顯示在觸發按鈕上的文本。和showOn設置為 “button” 或 “both”時結合使用。
calculateWeek:一個函數來計算當前周是一年中的第幾周。 默認實現使用ISO8601的定義:的定義執行:每週從週一開始;每年的第一個星期包含這年的第一個星期四。注:這意味著今年的第一周中可能會包含去年的3天,並且今年的3天可能會被包含進去年的最後一周中。
changeMonth:允許你將月份修改為一個下拉式功能表。 你可以將參數設置為false來禁用此功能,也就是顯示為文字。
changeYear:允許你將年份修改為一個下拉式功能表。 你可以將參數設置為false來禁用此功能,也就是顯示為文字。使用yearRange選項來控制哪些年是可供選擇。
closeText:關閉連接顯示的文字。使用showButtonPanel選項以顯示此按鈕。
constrainInput:當值為true時,在輸入欄的輸入被限制為當前的日期格式dateFormat選項允許的字元。
currentText:當前日期連結以文本形式顯示。使用 showButtonPanel選項以顯示此按鈕。
dateFormat:描述和顯示日期的格式。 對於可能的格式的完整清單,請參閱formatDate函數。
dayNames:日期長的名字的列表,從星期日(Sunday)開始,依照 dateFormat的設置進行使用。
dayNamesMin:日期最小化簡稱的列表, 從周日開始(Sunday), 用在datepicker每列的頭部.。
dayNamesShort:日期名稱的簡寫的列表, 從周日開始(Sunday), 依照dateFormat的設置使用。
defaultDate:如果該欄位為空時設置第一次打開時顯示的日期。 通過Date物件或字串在當前 dateFormat中指定任何一個實際的日期, 或者一個和今天對比的數字(例如 +7) 或者一個連續的字串值(‘y’ 表示年, ‘m’ 表示月, ‘w’表示周, ‘d’表示日, 例如. ‘+1m +7d’), 或者為空則是今天.
duration:設置datepicker展開動畫的顯示時間,可以是一個毫秒值, 也可以使用以下的三種字元值來表示(“slow”, “normal”, “fast”), 或者為 ”則馬上顯示。
firstDay:設置一周中的第一天:周日是 0, 週一是 1, 以此類推。
gotoCurrent:如果設置為true, 當前日的連結將移動到當前選中的日期,而不是今天。
hideIfNoPrevNext:通常當前一個和下一個連結被禁用時不適用 (參看 minDate 和 maxDate). 你可以通過設置此屬性為true完全的隱藏他們.
isRTL:當前語言描述是否為自右向左的。(注:例如阿拉伯語)
maxDate:最大的可選日期。當設置為null時,沒有上限。
minDate:最小的可選日期。當設置為null時,沒有下限。
monthNames:月份的完全名稱列表,依照 dateFormat的設置進行使用。
monthNamesShort:月份簡寫名稱的列表,依照 dateFormat的設置進行使用。
navigationAsDateFormat:確定是prevText 和 nextText選項是否應該被解析為formatDate函數的日期,讓他們能夠顯示目標的月份名稱.
nextText:下個月連結顯示的文字 。使用標準ThemeRoller樣式, 這個值被替換為一個圖示。
numberOfMonths:設置一次顯示幾個月.支援多個類型:
Number:一行顯示的月份數
Array:一個陣列定義的顯示行數和列數。
onChangeMonthYear:當datepicker移動到一個新的月份 並/或 年份時調用。 該函數接收選定的年份, 月份(1-12), 和datepicker實例作為參數。 this指向相關聯的輸入域。
onClose:當datepicker關閉時調用,確定一個日期是否被選中。 該函數接收所選日期的文本(””如果沒有)和datepicker實例作為參數。 this指向相關聯的輸入域。
onSelect:當選擇datepicker調用。 該函數接收所選日期的文本和datepicker實例作為參數。this指向相關聯的輸入域。
prevText:上個月連結顯示的文字 。使用標準ThemeRoller樣式, 這個值被替換為一個圖示。
selectOtherMonths:顯示在當前月份的之前或之後的日期是否可以被選擇。(注:比如2014年4月1日是週二,如果showOtherMonths選項設置為true,那麼2014年3月31日,2014年3月30日會以灰色的形式顯示在4月份的面板上,這個選項表示在4月份的面板上是否可以選擇2014年3月31日,2014年3月30日這兩個日期。5月也是一樣的。) 這選項僅適用於 如果showOtherMonths選項設置為true的時候。
shortYearCutoff:設置一個定義日期所處實際的截斷年份值(與dateFormat中的 ‘y’共同使用). 如果是一個數值 (0-99)那麼將直接使用這些值. 如果提供的是一個字串值那麼它將被轉換為數值添加到當前年. 一旦截斷年開始計算, 任何輸入的日期的年份小於或者等於它的話將被判定為在本世紀,大於他的將被判定為在上個世紀.
showAnim:設置顯示/隱藏datepicker的動畫名稱. 使用 “show” (默認), “slideDown”, “fadeIn”, 或其他任何jQuery UI effects的顯示/隱藏效果。 設置為空字串可以禁用動畫,即直接顯示或者隱藏。
showButtonPanel:是否顯示日曆下方的按鈕面板。 按鈕面板包含兩個按鈕, 一個今天按鈕連結到當前日期, 和一個完成按鈕關閉datepicker。 該按鈕的文本可以使用currentText 和 closeText選項分別進行定制。
showCurrentAtPos:通過numberOfMonths選項設置多月份顯示的情況下,當前月份顯示的位置。(注:自頂部/左邊開始第n位,以0開始計數。)
showMonthAfterYear:是否在面板的頭部年份後面顯示月份。
showOn:設置觸發datepicker自動出現的事件名稱,是focus (“focus”)還是clicked (“button”)或者任何事件(“both”)。
showOptions:如果想showAnim選項來使用jQuery UI effects動畫效果, 你可以為動畫提供一些額外的設置.
showOtherMonths:是否在當前月份面板顯示上、下兩個月的一些日期數(不可選)。 想要讓這些日期可選,請使用selectOtherMonths選項。
showWeek:如果為true,面板將增加一列,顯示一年中的哪一周。 該calculateWeek選項決定一年中的哪一周是如何計算的。 您可以改變 firstDay選項。
stepMonths:當點擊上/下一月連結時,一次翻幾個月。
weekHeader:本年度哪一周 列的標題顯示文本。 使用showWeek選項以顯示此列。
yearRange:控制年份的下拉清單中顯示的年份數量,可以是相對當前年(-nn:+nn),相對於選擇年份(-nn:+nn),也可以是絕對值(“nnnn:nnnn”),或這些格式的組合 (“nnnn:-nn”)。 請注意,此選項僅影響下拉清單中的顯示, 使用minDate 和/或 maxDate選項限制哪些日期可以選擇。
yearSuffix:顯示在月份頭部中年份後面的文本。

Comments