Bootstrap 生態裡的日期元件大致分兩類:擅長「單一時間點」的 DateTimePicker,以及擅長「一段時間區間」的 DateRangePicker。搞懂兩者的定位,就不會為了選一個日期而引入龐大的區間控制項。
它需要先載入樣式、腳本、中文語系檔,以及底層依賴的 moment.js。順序有講究:moment 必須在元件之前。
<link rel="stylesheet" href="css/bootstrap-datetimepicker.min.css"> <script src="js/moment.min.js"></script> <script src="js/bootstrap-datetimepicker.min.js"></script> <script src="js/bootstrap-datetimepicker.zh-CN.js"></script>
參數說明可對照官方文件:https://www.bootcss.com/p/bootstrap-datetimepicker/。
這類元件最實用的地方是「常用區間快速鍵」,例如今日、昨日、最近七日、最近三十日,對報表查詢場景特別合適。
<link rel="stylesheet" href="css/daterangepicker-bs3.css"> <script src="js/moment.min.js"></script> <script src="js/daterangepicker.js"></script>
HTML 部分只需要一個容器,元件會自行注入內容:
<div class="container-fluid">
<div class="row-fluid" style="margin-top:5px">
<div class="span4">
<div class="control-group">
<label class="control-label">日期:</label>
<div class="controls">
<div id="reportrange" class="pull-left dateRange" style="width:350px">
<i class="glyphicon glyphicon-calendar fa fa-calendar"></i>
<span id="searchDateRange"></span>
<b class="caret"></b>
</div>
</div>
</div>
</div>
</div>
</div>
幾個實務上常用的參數:maxDate 限制不能選未來、dateLimit 限制區間跨度、timePicker 打開時分選擇、locale 一次搞定所有中文標籤。
$(document).ready(function (){
//預設顯示「一小時前 ~ 現在」
$('#reportrange span').html(
moment().subtract('hours', 1).format('YYYY-MM-DD HH:mm:ss') + ' - ' +
moment().format('YYYY-MM-DD HH:mm:ss')
);
$('#reportrange').daterangepicker({
maxDate: moment(), //最大時間:不允許選未來
dateLimit: { days: 30 }, //起訖最大間隔
showDropdowns: true,
showWeekNumbers: false,
timePicker: true,
timePickerIncrement: 60, //時間增量,單位分鐘
timePicker12Hour: false, //使用 24 小時制
ranges: {
'今日': [moment().startOf('day'), moment()],
'昨日': [moment().subtract('days', 1).startOf('day'), moment().subtract('days', 1).endOf('day')],
'最近7日': [moment().subtract('days', 6), moment()],
'最近30日': [moment().subtract('days', 29), moment()]
},
opens: 'right',
buttonClasses: ['btn btn-default'],
applyClass: 'btn-small btn-primary blue',
cancelClass: 'btn-small',
format: 'YYYY-MM-DD HH:mm:ss',
separator: ' to ',
locale: {
applyLabel: '確定',
cancelLabel: '取消',
fromLabel: '起始時間',
toLabel: '結束時間',
customRangeLabel: '自定義',
daysOfWeek: ['日','一','二','三','四','五','六'],
monthNames: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'],
firstDay: 1
}
}, function(start, end, label){
$('#reportrange span').html(
start.format('YYYY-MM-DD HH:mm:ss') + ' - ' + end.format('YYYY-MM-DD HH:mm:ss')
);
});
});
報表頁最常見的組合是「日期控制項 + 表格」。做法是把日期字串塞進 DataTables 的額外參數,再監聽 apply.daterangepicker 事件觸發 ajax.reload()。
var table;
$(function () {
table = $('#example').DataTable({
"ajax": {
"url": "/example/resources/server_processing_customCUrl.php",
"data": function ( d ) {
//把日期區間當成額外參數送給後端
d.extra_search = $('#reportrange span').html();
}
},
"processing": true,
"serverSide": true,
"language": {
"sProcessing": "處理中...",
"sLengthMenu": "顯示 _MENU_ 項結果",
"sZeroRecords": "沒有匹配結果",
"sInfo": "顯示第 _START_ 至 _END_ 項結果,共 _TOTAL_ 項",
"sInfoEmpty": "顯示第 0 至 0 項結果,共 0 項",
"sInfoFiltered": "(由 _MAX_ 項結果過濾)",
"sSearch": "搜索:",
"sEmptyTable": "表中數據為空",
"sLoadingRecords": "載入中...",
"oPaginate": { "sFirst": "首頁", "sPrevious": "上頁", "sNext": "下頁", "sLast": "末頁" }
},
"dom": "<'row'<'span9'l<'#mytoolbox'>><'span3'f>r>t<'row'<'span6'i><'span6'p>>",
initComplete: initComplete
});
function initComplete(){
var dataPlugin =
'<div id="reportrange" class="pull-left dateRange" style="width:400px;margin-left:10px">' +
'日期:<i class="glyphicon glyphicon-calendar fa fa-calendar"></i>' +
'<span id="searchDateRange"></span><b class="caret"></b></div>';
$('#mytoolbox').append(dataPlugin);
$('#reportrange span').html(
moment().subtract('hours', 1).format('YYYY-MM-DD HH:mm:ss') + ' - ' +
moment().format('YYYY-MM-DD HH:mm:ss')
);
$('#reportrange').daterangepicker({
maxDate: moment(),
dateLimit: { days: 30 },
showDropdowns: true,
timePicker: true,
timePickerIncrement: 60,
timePicker12Hour: false,
ranges: {
'今日': [moment().startOf('day'), moment()],
'昨日': [moment().subtract('days', 1).startOf('day'), moment().subtract('days', 1).endOf('day')],
'最近7日': [moment().subtract('days', 6), moment()],
'最近30日': [moment().subtract('days', 29), moment()]
},
opens: 'right',
format: 'YYYY-MM-DD HH:mm:ss',
separator: ' to ',
locale: {
applyLabel: '確定', cancelLabel: '取消',
fromLabel: '起始時間', toLabel: '結束時間', customRangeLabel: '自定義',
daysOfWeek: ['日','一','二','三','四','五','六'],
monthNames: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'],
firstDay: 1
}
}, function(start, end){
$('#reportrange span').html(
start.format('YYYY-MM-DD HH:mm:ss') + ' - ' + end.format('YYYY-MM-DD HH:mm:ss')
);
});
//可選:依後端回傳的條件,反白對應的快速鍵
var dateOption;
if ("${riqi}" == 'day') { dateOption = "今日"; }
else if ("${riqi}" == 'yday') { dateOption = "昨日"; }
else if ("${riqi}" == 'week') { dateOption = "最近7日"; }
else if ("${riqi}" == 'month') { dateOption = "最近30日"; }
else if ("${riqi}" == 'year') { dateOption = "最近一年"; }
else { dateOption = "自定義"; }
$(".daterangepicker").find("li").each(function (){
if ($(this).hasClass("active")) { $(this).removeClass("active"); }
if (dateOption == $(this).html()) { $(this).addClass("active"); }
});
//選完時間就重新拉資料
$("#reportrange").on('apply.daterangepicker', function(){
table.ajax.reload();
var args = table.ajax.params();
console.log("額外傳到後台的參數 extra_search:" + args.extra_search);
});
}
});
月份名稱顯示異常時,優先檢查 moment 的語系檔是否正確載入,而不是直接改 moment.min.js——壓縮檔一改,下次升版就白工。透過 locale 參數或載入對應語系檔才是長久之計。
至於選哪一個:daterangepicker.com 官網文件最完整,但操作習慣偏重;若是 Bootstrap 3 專案,daterangepicker-bs3 的整合度更順手。先想清楚你要的是「一個時間點」還是「一段區間」,答案通常就出來了。