jQuery日期范围选择器附源码下载

jquery date range picker是一款允许用户选择一个日期时间范围的jquery日期选择器插件。整个日期选择器插件使用css来渲染样式，可以非常容易的使用css来定制皮肤。而且浏览器兼容性非常好，支持多种时间格式。

             

准备

使用该日期选择器插件需要 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结构

在需要放置日期选择器的地方添加以下html结构，就是一个输入框。

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

调用插件

调用jquery date range picker插件非常简单，和其他常见的jquery插件一样：

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

配置参数

该日期选择器的默认配置参数如下：

{ 
 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的日期格式。点击这里查看moment文档。

separator (string)：日期字符串之间的分隔符。

language (string)：预定义的语言是"en"和"cn"。你可以使用这个参数自定义语言。也可以设置为"auto"来让浏览器自己检测语言。

startofweek (string)："sunday" 或 "monday"。

getvalue (function)：当从dom元素中获取日期范围时会调用该函数，函数的上下文被设置为datepicker dom。

setvalue (function)：当向dom元素中写入日期范围时调用该函数。

startdate (string or false)：定义用户允许的最早日期，格式和format相同。

enddate (string or false)：定义用户允许的最后日期，格式和format相同。

mindays (number) ：该参数定义日期范围的最小天数，如果设置为0，表示不限制最小天数。

maxdays (number)：该参数定义日期范围的最大天数，如果设置为0，表示不限制最大天数。

showshortcuts (boolean) ：先生或隐藏shortcuts区域。

time (object)：如果允许该参数就会添加时间的范围选择。

shortcuts (object)：定义快捷键按钮。

customshortcuts (array)：定义自定义快捷键按钮。

inline (boolean)：使用inline模式渲染该日期选择器，而不是overlay模式。如果设置为true，则要一起设置container参数。

container (string, css selector || dom object) ：要进行渲染的日期选择器dom元素。

alwaysopen (boolean)：如果使用inline模式，你可能希望在页面加载时就渲染日期选择器。该参数设置为true时会隐藏"close"按钮。

singledate (boolean)：设置为true可以选择单个的日期。

batchmode (false / 'week' / 'month')：自动批处理模式。

事件

当该日期选择器在dom中选择某个日期范围时会触发三个事件。

$('#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

在你调用$(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    

项目地址：

以上所述是小编给大家介绍的jquery日期范围选择器附源码下载，希望对大家有所帮助