jQuery Date Range Picker是一款允許用戶選擇一個(gè)日期時(shí)間范圍的jQuery日期選擇器插件。整個(gè)日期選擇器插件使用CSS來渲染樣式，可以非常容易的使用CSS來定制皮膚。而且瀏覽器兼容性非常好，支持多種時(shí)間格式。

查看演示             下載源碼

準(zhǔn)備

使用該日期選擇器插件需要 jQuery 1.3.2+和Moment 2.2.0+的支持。

<link rel="stylesheet" href="css/daterangepicker.css" rel="external nofollow" /> 
<script src="js/moment.min.js"></script> 
<script src="js/jquery.daterangepicker.js"></script> 

HTML結(jié)構(gòu)

在需要放置日期選擇器的地方添加以下html結(jié)構(gòu)，就是一個(gè)輸入框。

<input type="text" id="datepicker" value=""> 

調(diào)用插件

調(diào)用jQuery Date Range Picker插件非常簡(jiǎn)單，和其他常見的jQuery插件一樣：

$('#datepicker').dateRangePicker(option); 

配置參數(shù)

該日期選擇器的默認(rèn)配置參數(shù)如下：

{ 
 format: 'YYYY-MM-DD', 
 separator: ' to ', 
 language: 'auto', 
 startOfWeek: 'sunday',// or monday 
 getValue: function() 
 { 
  return this.value; 
 }, 
 setValue: function(s) 
 { 
  this.value = s; 
 }, 
 startDate: false, 
 endDate: false, 
 minDays: 0, 
 maxDays: 0, 
 showShortcuts: true, 
 time: { 
  enabled: false 
 }, 
 shortcuts: 
 { 
  //'prev-days': [1,3,5,7], 
  'next-days': [3,5,7], 
  //'prev' : ['week','month','year'], 
  'next' : ['week','month','year'] 
 }, 
 customShortcuts : [], 
 inline:false, 
 container: 'body', 
 alwaysOpen:false, 
 singleDate:false, 
 batchMode:false, 
 beforeShowDay: [function], 
 dayDivAttrs: [], 
 dayTdAttrs: [], 
 applyBtnClass: '' 
} 

format (String)：Moment的日期格式。點(diǎn)擊這里查看Moment文檔。

separator (String)：日期字符串之間的分隔符。

language (String)：預(yù)定義的語言是"en"和"cn"。你可以使用這個(gè)參數(shù)自定義語言。也可以設(shè)置為"auto"來讓瀏覽器自己檢測(cè)語言。

startOfWeek (String)："sunday" 或 "monday"。

getValue (Function)：當(dāng)從DOM元素中獲取日期范圍時(shí)會(huì)調(diào)用該函數(shù)，函數(shù)的上下文被設(shè)置為datepicker DOM。

setValue (Function)：當(dāng)向DOM元素中寫入日期范圍時(shí)調(diào)用該函數(shù)。

startDate (String or false)：定義用戶允許的最早日期，格式和format相同。

endDate (String or false)：定義用戶允許的最后日期，格式和format相同。

minDays (Number) ：該參數(shù)定義日期范圍的最小天數(shù)，如果設(shè)置為0，表示不限制最小天數(shù)。

maxDays (Number)：該參數(shù)定義日期范圍的最大天數(shù)，如果設(shè)置為0，表示不限制最大天數(shù)。

showShortcuts (Boolean) ：先生或隱藏shortcuts區(qū)域。

time (Object)：如果允許該參數(shù)就會(huì)添加時(shí)間的范圍選擇。

shortcuts (Object)：定義快捷鍵按鈕。

customShortcuts (Array)：定義自定義快捷鍵按鈕。

inline (Boolean)：使用inline模式渲染該日期選擇器，而不是overlay模式。如果設(shè)置為true，則要一起設(shè)置container參數(shù)。

container (String, css selector || DOM Object) ：要進(jìn)行渲染的日期選擇器DOM元素。

alwaysOpen (Boolean)：如果使用inline模式，你可能希望在頁面加載時(shí)就渲染日期選擇器。該參數(shù)設(shè)置為true時(shí)會(huì)隱藏"close"按鈕。

singleDate (Boolean)：設(shè)置為true可以選擇單個(gè)的日期。

batchMode (false / 'week' / 'month')：自動(dòng)批處理模式。

事件

當(dāng)該日期選擇器在DOM中選擇某個(gè)日期范圍時(shí)會(huì)觸發(fā)三個(gè)事件。

$('#datepicker') 
.dateRangePicker() 
.bind('datepicker-change',function(event,obj) 
{ 
 console.log(obj); 
 // obj will be something like this: 
 // { 
 //  date1: (Date object of the earlier date), 
 //  date2: (Date object of the later date), 
 //  value: "2013-06-05 to 2013-06-07" 
 // } 
}) 
.bind('datepicker-apply',function(event,obj) 
{ 
 console.log(obj); 
}) 
.bind('datepicker-close',function() 
{ 
 console.log('close'); 
}); 

API

在你調(diào)用$(dom).dateRangePicker()之后：

$(dom).data('dateRangePicker') 
 .setDateRange('2013-11-20','2013-11-25'); //set date range, two date strings should follow the `format` in config object 
 .clear(); // clear date range 
 .close(); // close date range picker overlay 
 .open(); // open date range picker overlay 
 .destroy(); // destroy all date range picker related things    

項(xiàng)目地址：https://github.com/longbill/jquery-date-range-picker

以上所述是小編給大家介紹的jQuery日期范圍選擇器附源碼下載，希望對(duì)大家有所幫助，如果大家有任何疑問請(qǐng)給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持！

最新評(píng)論