DIV CSS 佈局教程網

可精確到分鐘的 JS 日曆控件:日期時間選擇器完整實作
編輯:JavaScript綜合知識     

我們平常看到的日曆控件,大多只能選到「年、月、日」為止。但實務上有不少情境需要更細的粒度——後台排程、活動報名、工單開通時間、排班系統等等,使用者往往需要一次輸入「2024-08-12 14:30」這樣的完整時間戳。本文要拆解的這支 JavaScript 日曆控件,就是在傳統日期面板下方多接了一片時間面板,讓日期與時間在同一個彈出視窗裡一次搞定。

這個控件能做到什麼

  • 年份用上下箭頭逐格增減,月份用下拉選單切換,日期格子依當月實際天數自動產生。
  • 時間列有「時」與「分」兩個輸入框,右側箭頭可逐格微調,到 23 或 59 會回到 0,反之亦然。
  • 輸入框可直接鍵入數字,失焦時自動補零成兩位數,非數字按鍵則被攔下。
  • 第一次開啟會帶入目前的日期與時間,不必從空白填起。
  • 任何一次改動,都會即時把結果寫回頁面上的目標欄位。
  • 點擊日曆以外的區域,面板自動收起。

整體程式結構

整份程式以兩個建構函式為骨架,各自負責一段資料,再由一個共用函式把結果拼起來:

  • CalendarCalendar:負責年、月、日,對外提供 getDate() 回傳格式化字串。
  • CalendarMinute:負責時、分,對外提供 getTime()。
  • getDateTime():把兩者串成 yyyy-MM-dd HH:mm,寫進 gdCtrl 目前指向的欄位。
  • showCal() 與 hideCalendar():控制面板定位與可見性。
  • fGetXY():逐層累加 offsetLeft/offsetTop,算出觸發欄位在頁面中的絕對座標。
  • validateDate1():把 yyyy-MM-dd HH:mm 這類格式字串動態轉成正則表達式,用來檢查欄位裡既有的值是否合法。

時間面板的核心片段

時間列的做法很巧妙:用兩個共用屬性字串套在每個 input 上,再用 radix 自訂屬性記錄「這一格的上限」,箭頭就能通用同一段邏輯。

function CalendarMinute(name, fName) {
  this.name  = name;
  this.fName = fName || "m_input";
  this.timer = null;
  this.fObj  = null;   // 目前聚焦的輸入框

  // 每格共用的屬性:最長 2 碼、聚焦時記住自己、失焦補零、禁止貼上與拖曳
  var sMinute_Common = 'class="m_input" maxlength="2" name="' + this.fName + '"'
    + ' onfocus="' + this.name + '.setFocusObj(this)"'
    + ' onblur="'  + this.name + '.setTime(this)"'
    + ' onkeyup="' + this.name + '.prevent(this)"'
    + ' onpaste="return false" ondragenter="return false"';

  // 上下箭頭;5 顯示向上、6 顯示向下(Webdings 字型會畫成三角形)
  var sButton_Common = 'class="m_arrow" onfocus="this.blur()"'
    + ' onmouseup="' + this.name + '.controlTime()" disabled';

  this.toString = function () {
    var d = new Date(), str = '';
    str += '<table class="cal_drawtime" cellspacing="0" cellpadding="0"><tr>';
    str += '<td>請選擇時間:</td><td><div class="m_frameborder">';
    str += '<input radix="24" value="' + this.formatTime(d.getHours())   + '" ' + sMinute_Common + '>:';
    str += '<input radix="60" value="' + this.formatTime(d.getMinutes()) + '" ' + sMinute_Common + '>';
    str += '</div></td><td>';
    str += '<button id="' + this.fName + '_up"   ' + sButton_Common + '>5</button>';
    str += '<button id="' + this.fName + '_down" ' + sButton_Common + '>6</button>';
    str += '</td></tr></table>';
    return str;
  };

  // 補零成兩位數
  this.formatTime = function (sTime) {
    sTime = "0" + sTime;
    return sTime.substr(sTime.length - 2);
  };

  // 箭頭微調,含到頂/到底的回圈處理
  this.controlTime = function () {
    event.cancelBubble = true;
    if (!this.fObj) return;
    clearInterval(this.timer);
    var up  = (event.srcElement.innerText == "5");
    var i   = parseInt(this.fObj.value, 10);
    var max = parseInt(this.fObj.radix, 10) - 1;
    if (i == max && up)     i = 0;
    else if (i == 0 && !up) i = max;
    else                    up ? i++ : i--;
    this.fObj.value = this.formatTime(i);
    this.fObj.select();
    getDateTime();
  };

  // 對外輸出 "HH:mm"
  this.getTime = function () {
    var box = document.getElementsByName(this.fName), arr = [];
    for (var i = 0; i < box.length; i++) arr[i] = box[i].value;
    return arr.join(":");
  };
}

日期格子的產生

日曆本體的關鍵只有兩行計算:用 new Date(year, month, 1).getDay() 求出該月一號是星期幾(也就是前面要留幾格空白),再用 new Date(year, month + 1, 0).getDate() 取得當月總天數。

this.drawDate = function () {
  var first = new Date(this.year, this.month, 1).getDay();       // 一號是星期幾
  var total = new Date(this.year, this.month + 1, 0).getDate();  // 當月總天數
  var str = '<table class="cal_drawdate" id="' + this.fName + '_dateTable">';
  for (var i = 1, j = 1 - first; i < 7; i++) {
    str += '<tr>';
    for (var k = 0; k < 7; k++, j++) {
      var day = (j >= 1 && j <= total) ? j : '';   // 前後非本月的格子留空
      str += '<td><span' + (j == this.date ? ' class="selected"' : '')
           + ' onclick="' + this.name + '.redrawDate(this.innerText)">' + day + '</span></td>';
    }
    str += '</tr>';
  }
  return str + '</table>';
};

this.getDate = function (delimiter) {
  var m = ("0" + (this.month + 1)).slice(-2);
  var d = ("0" + this.date).slice(-2);
  return [this.year, m, d].join(delimiter || "-");
};

在頁面裡引用

<input type="text" id="bgntime" name="bgntime" onClick="showCal(bgntime);">

<div id="dateTime" onclick="event.cancelBubble=true"
     style="position:absolute; visibility:hidden; z-index:100;">
  <table class="cal_table" border="0">
    <tr><td>
      <script>var c = new CalendarCalendar('c'); document.write(c);</script>
    </td></tr>
    <tr><td align="center">
      <script>var m = new CalendarMinute('m'); document.write(m);</script>
    </td></tr>
  </table>
</div>

<!-- 點擊文件任何處即收起面板 -->
<script event="onclick" for="document">hideCalendar()</script>

幾個實務上的提醒

這份程式寫於 IE 一手遮天的年代,因此大量使用了 event.srcElement、document.write()、<script event= for=> 這類僅 Internet Explorer 認得的寫法,在今日的 Chrome、Firefox、Safari 中會失效。它的價值在於「用極少的程式碼把日期與時間面板拼在一起」這個思路,以及用 radix 自訂屬性統一處理數值上限的小技巧。

若是新專案,建議改用原生的 <input type="datetime-local">,或挑一套仍在維護的日期時間選擇器套件(多數已支援鍵盤操作、i18n 與手勢),並把「不可選過去日期」「時區」這些規則交給後端再驗證一次,前端校驗永遠只能當作文不對題時的第一道提示。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved