使用 bootstrap-datetimepicker 製作「開始日期」與「結束日期」兩個輸入框時,實務上一定會遇到一個需求:結束日期不能早於開始日期。以下示範如何透過 setStartDate 與 setEndDate 讓兩者互相牽制。
changeDate: function (starttime, stoptime) {
// 比較時間大小,不符規則時彈出提示
var _t = this;
if (stoptime != '' && starttime != '') {
if (stoptime < starttime) {
$('#stop-date').val('');
$('#time').modal('show');
setTimeout(function () { $('#time').modal('hide'); }, 3000);
return;
}
}
},
這裡利用字串比較即可判斷日期先後,因為格式固定為 yyyy-mm-dd 時,字典序剛好等同時間序。
timeDatapicker: function () {
var _t = this;
var startDate = $('#start-date'), // 開始時間
stopDate = $('#stop-date'); // 結束時間
startDate.datetimepicker({
format: 'yyyy-mm-dd',
autoclose: true,
minView: 2,
language: 'zh-CN'
})
.on('change', function () {
// changeDate 掛在 change 之後,是為了避免與 change 事件衝突
var starttime = startDate.val();
var stoptime = stopDate.val();
_t.changeDate(starttime, stoptime);
// 結束日期的下限重新設為剛剛選的開始日期
stopDate.datetimepicker('setStartDate', starttime);
})
.on('changeDate', function () {
var starttime = startDate.val();
stopDate.datetimepicker('setStartDate', starttime);
var stoptime = stopDate.val();
});
stopDate.datetimepicker({
format: 'yyyy-mm-dd',
autoclose: true,
minView: 2,
language: 'zh-CN'
})
.on('change', function () {
var starttime = startDate.val();
var stoptime = stopDate.val();
_t.changeDate(starttime, stoptime, $(this));
})
.on('changeDate', function () {
var starttime = startDate.val();
var stoptime = stopDate.val();
// 反向牽制:開始日期的上限不能超過結束日期
startDate.datetimepicker('setEndDate', stoptime);
stopDate.datetimepicker('setStartDate', starttime);
});
},
關鍵在於兩組 API 的搭配:
・setStartDate:設定可選日期的下限,用在結束日期上,讓它無法選到開始日期之前。
・setEndDate:設定可選日期的上限,用在開始日期上,讓它無法選到結束日期之後。
另外有兩個實作細節值得留意。第一,changeDate 要掛在 change 之後註冊,否則兩個監聽器可能互相觸發造成迴圈。第二,同時監聽 change 與 changeDate 是因為前者在使用者輸入或選擇時觸發,後者則在程式以 API 改寫數值時觸發,兩者都攔下來才能涵蓋所有路徑。
若需要更完整的驗證(例如限制可選的日期區間、排除週末與假日),可以搭配 datesDisabled、startDate/endDate 這些初始化參數處理,會比在 change 事件裡逐一比對來得乾淨。