jQuery Date Range Picker时间插件API
jQuery Date Range Picker是一款允许用户选择一个日期时间范围的jQuery日期选择器插件。整个日期选择器插件使用CSS来渲染样式，可以非常容易的使用CSS来定制它的皮肤。它的兼容性非常好，支持IE6+的IE浏览器。
该日期选择器的特点有：
（1）支持IE6+, Firefox, Chrome, Safari和其他标准的HTML5浏览器。
（2）支持多种语言。
（3）使用CSS来渲染样式。
（4）容易使用和定制。
（5）支持多种时间格式。
工具/原料
- 笔记本电脑或是台式机
- 互联网
- jQuery
- jQuery Date Range Picker
方法/步骤
- 1
在Github上下载 jQuery Date RangePicker，如下图所示：
- 2
使用该日期选择器插件需要 jQuery 1.3.2+和Moment2.2.0+的支持。
- 3
$('#dom-id').dateRangePicker(configObject);
- 4
该日期选择器的默认配置参数如下：
- 5
format (String)：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')：自动批处理模式。
- 6
当该日期选择器在DOM中选择某个日期范围时会触发三个事件。
$('#dom-id')
.dateRangePicker()
.bind('datepicker-change',function(event,obj)
{
console.log(obj);
// obj will be something like this:
// {
// date1: (Date objectof the earlier date),
// date2: (Date objectof 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');
});
- 7
调用$(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(); // cleardate range
.close(); // closedate range picker overlay
.open(); //open date range picker overlay
.destroy(); // destroy all daterange picker relatedthings
- 8
jQuery可选择日期范围的日期选择器插件 A jQuery plugin that allows user to select a daterange
Demonstrations
Default settings with time enabled:
{
startOfWeek: 'monday',
separator : ' ~ ',
format: 'DD.MM.YYYY HH:mm',
autoClose: false,
time: {
enabled: true
}
}
- 9
运行效果如下图所示：
