jQuery Date Range Picker时间插件API
2016-12-09 15:29
681 查看
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+的支持。
<link rel="stylesheet"href="daterangepicker.css" />
<scriptsrc="moment.min.js"></script>
<scriptsrc="jquery.daterangepicker.js"></script>
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):
4000
如果允许该参数就会添加时间的范围选择。
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
<!doctype html>
<html>
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible"content="IE=edge,chrome=1">
<meta name="viewport"content="width=device-width, initial-scale=1.0">
<title>jQuery可选择日期范围的日期选择器插件</title>
<link rel="stylesheet"type="text/css" href="css/normalize.css" />
<link rel="stylesheet"type="text/css" href="css/default.css">
<link rel="stylesheet"href="css/daterangepicker.css" />
<script src="js/jquery-1.11.2.min.js"></script>
<scriptsrc="js/moment.min.js"></script>
<scriptsrc="js/jquery.daterangepicker.js"></script>
<script src="js/demo.js"></script>
<!--[if IE]>
<scriptsrc="http://libs.useso.com/js/html5shiv/3.7/html5shiv.min.js"></script>
<![endif]-->
<style>
#wrapper
{
width:800px;
margin:0 auto;
color:#333;
font-family:Tahoma;
line-height:1.5;
font-size:14px;
}
.demo { margin:30px 0;}
.date-picker-wrapper .month-wrapper table .day.lalala {background-color:orange; }
.options { display:none; border-left:6px solid #8ae;padding:10px; font-size:12px; line-height:1.4; background-color:#eee;border-radius:4px;}
</style>
</head>
<body>
<div>
<header>
<h1>jQuery可选择日期范围的日期选择器插件 <span>A jQuery plugin that allows user to select a daterange</span></h1>
<div>
<a class="htmleaf-iconicon-htmleaf-home-outline" href="http://www.htmleaf.com/"title="jQuery之家"target="_blank"><span> jQuery之家</span></a>
<a class="htmleaf-iconicon-htmleaf-arrow-forward-outline" href="http://www.htmleaf.com/jQuery/Calendar-Date-Time-picker/201504251737.html"title="返回下载页"target="_blank"><span> 返回下载页</span></a>
</div>
</header>
<div class="htmleaf-content bgcolor-3">
<h2>Demonstrations</h2>
<div>
Default settings: <input id="date-range0"size="30" value="">
<a href="#">Show Config</a>
<pre>
{}</pre>
</div>
<div>
Default settings with time enabled: <inputid="date-range1" size="30" value="">
<a href="#">Show Config</a>
<pre>
{
startOfWeek: 'monday',
separator : ' ~ ',
format: 'DD.MM.YYYY HH:mm',
autoClose: false,
time: {
enabled: true
}
}</pre>
</div>
<div>
Default settings with default value: <inputid="date-range2" size="30" value="2013-10-01 to2013-11-04">
<a href="#">Show Config</a>
<pre>
{}</pre>
</div>
<div>
Force to Chinese: <input id="date-range3"size="30" value="">
<a href="#">Show Config</a>
<pre>
{
language:'cn'
}</pre>
</div>
<div>
Force to English: <input id="date-range4"size="30" value="">
<a href="#">Show Config</a>
<pre>
{
language:'en'
} </pre>
</div>
<div>
Sticky months: <input id="date-range17"size="30" value="">
<a href="#">Show Config</a>
<pre>
{
stickyMonths: true,
startDate: '2013-01-10',
endDate: '2013-05-10'
} </pre>
</div>
</div>
</div>
<script>
$(function()
{
$('a.show-option').click(function(evt)
{
evt.preventDefault();
$(this).siblings('.options').slideToggle();
});
})
</script>
</body>
</html>
9
运行效果如下图所示:
该日期选择器的特点有:
(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+的支持。
<link rel="stylesheet"href="daterangepicker.css" />
<scriptsrc="moment.min.js"></script>
<scriptsrc="jquery.daterangepicker.js"></script>
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):
4000
如果允许该参数就会添加时间的范围选择。
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
<!doctype html>
<html>
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible"content="IE=edge,chrome=1">
<meta name="viewport"content="width=device-width, initial-scale=1.0">
<title>jQuery可选择日期范围的日期选择器插件</title>
<link rel="stylesheet"type="text/css" href="css/normalize.css" />
<link rel="stylesheet"type="text/css" href="css/default.css">
<link rel="stylesheet"href="css/daterangepicker.css" />
<script src="js/jquery-1.11.2.min.js"></script>
<scriptsrc="js/moment.min.js"></script>
<scriptsrc="js/jquery.daterangepicker.js"></script>
<script src="js/demo.js"></script>
<!--[if IE]>
<scriptsrc="http://libs.useso.com/js/html5shiv/3.7/html5shiv.min.js"></script>
<![endif]-->
<style>
#wrapper
{
width:800px;
margin:0 auto;
color:#333;
font-family:Tahoma;
line-height:1.5;
font-size:14px;
}
.demo { margin:30px 0;}
.date-picker-wrapper .month-wrapper table .day.lalala {background-color:orange; }
.options { display:none; border-left:6px solid #8ae;padding:10px; font-size:12px; line-height:1.4; background-color:#eee;border-radius:4px;}
</style>
</head>
<body>
<div>
<header>
<h1>jQuery可选择日期范围的日期选择器插件 <span>A jQuery plugin that allows user to select a daterange</span></h1>
<div>
<a class="htmleaf-iconicon-htmleaf-home-outline" href="http://www.htmleaf.com/"title="jQuery之家"target="_blank"><span> jQuery之家</span></a>
<a class="htmleaf-iconicon-htmleaf-arrow-forward-outline" href="http://www.htmleaf.com/jQuery/Calendar-Date-Time-picker/201504251737.html"title="返回下载页"target="_blank"><span> 返回下载页</span></a>
</div>
</header>
<div class="htmleaf-content bgcolor-3">
<h2>Demonstrations</h2>
<div>
Default settings: <input id="date-range0"size="30" value="">
<a href="#">Show Config</a>
<pre>
{}</pre>
</div>
<div>
Default settings with time enabled: <inputid="date-range1" size="30" value="">
<a href="#">Show Config</a>
<pre>
{
startOfWeek: 'monday',
separator : ' ~ ',
format: 'DD.MM.YYYY HH:mm',
autoClose: false,
time: {
enabled: true
}
}</pre>
</div>
<div>
Default settings with default value: <inputid="date-range2" size="30" value="2013-10-01 to2013-11-04">
<a href="#">Show Config</a>
<pre>
{}</pre>
</div>
<div>
Force to Chinese: <input id="date-range3"size="30" value="">
<a href="#">Show Config</a>
<pre>
{
language:'cn'
}</pre>
</div>
<div>
Force to English: <input id="date-range4"size="30" value="">
<a href="#">Show Config</a>
<pre>
{
language:'en'
} </pre>
</div>
<div>
Sticky months: <input id="date-range17"size="30" value="">
<a href="#">Show Config</a>
<pre>
{
stickyMonths: true,
startDate: '2013-01-10',
endDate: '2013-05-10'
} </pre>
</div>
</div>
</div>
<script>
$(function()
{
$('a.show-option').click(function(evt)
{
evt.preventDefault();
$(this).siblings('.options').slideToggle();
});
})
</script>
</body>
</html>
9
运行效果如下图所示:
相关文章推荐
- 一款贴近用户体验的jQuery日期选择插件。这是一款双日历jQuery日期选择时间插件pickerDateRange。
- Jquery datepicker时间插件并且转中文
- 基于jQuery UI Datepicker实现的时间插件
- 第一好用的时间 日期插件(Adding a Timepicker to jQuery UI Datepicker)
- 日期时间范围选择插件:daterangepicker使用总结(必看篇)
- Jquery datepicker 时间插件使用 js 时间相加,相减
- jQuery dateRangePicker插件使用方法详解
- 日期时间范围选择插件-daterangepicker使用总结
- jQuery插件Datepicker日期选择器实现Javascript自定义日期时间选择功能
- 时间插件--daterangepicker使用和配置详解
- jquery双日历插件daterangepicker.js设置可选时间时分秒
- jquery jQueryUIDatepicker时间插件设置
- jquery datepicker时间插件
- jQuery dateRangePicker插件使用总结
- JQuery日期插件datepicker的使用
- Date Range Picker using jQuery UI 1.7 and jQuery UI CSS Framework
- [置顶] JQuery日期插件datepicker的使用
- jQuery学习之:Datepicker日期选择插件
- jQuery-ui插件datepicker的参数使用详解
- jquery datepicker 插件使用