使用 jQuery UI Datepicker 实现月份和年份选择教程-html教程-PHP中文网

使用 jQuery UI Datepicker 实现月份和年份选择教程

碧海醫心

发布： 2025-11-09 12:45:22

原创

217人浏览过

使用 jQuery UI Datepicker 实现月份和年份选择教程

本教程详细指导如何使用 jquery ui datepicker 实现仅选择月份和年份的功能，并构建一个联动日期范围选择器。文章将涵盖必要的库文件引入、html结构、关键的javascript配置（包括 `onclose` 事件处理和 `dateformat` 设置），以及如何通过 css 隐藏日历视图。此外，还将介绍如何实现“开始日期”和“结束日期”之间的联动校验，确保用户选择的日期范围逻辑正确，同时支持本地文件引入而非cdn。

一、引言与核心概念

在许多业务场景中，我们可能只需要用户选择特定的月份和年份，而非具体的某一天。jQuery UI Datepicker 是一个功能强大的日期选择器组件，通过巧妙的配置和事件处理，可以轻松实现这一需求。本教程将展示如何配置 Datepicker 以仅显示月份和年份选择器，并结合“开始日期”和“结束日期”的联动校验功能。

实现此功能的核心在于以下几个 jQuery UI Datepicker 选项：

changeMonth: true 和 changeYear: true：启用月份和年份的下拉选择器。
showButtonPanel: true：显示底部按钮面板，通常包含“今天”和“完成”按钮，这对于月份/年份选择模式很有用。
dateFormat: 'mm-yy'：设置输入框中日期的显示格式，例如“01-2023”。
onClose 事件：这是最关键的部分。当 Datepicker 关闭时，我们需要手动从其内部的月份和年份下拉框中获取用户选择的值，然后使用这些值来设置输入框的最终日期。
CSS 样式：通过简单的 CSS 规则隐藏日历中的日期部分，进一步强化只选择月份和年份的意图。

二、环境准备：引入必要的库文件

要使用 jQuery UI Datepicker，您需要引入 jQuery 库、jQuery UI JavaScript 文件以及 jQuery UI 的 CSS 样式表。为了满足不使用 CDN 的需求，您可以将这些文件下载到本地项目目录中。

以下是您需要下载并引入的三个文件（您可以右键点击链接并选择“另存为”）：

jQuery 库: https://www.php.cn/link/a6a2b3e3c6569e69afe1e025d0ff8d1f
jQuery UI JavaScript: https://www.php.cn/link/6508deb7d1b89059767d5af370618046
jQuery UI 基础主题 CSS: https://www.php.cn/link/b1e895366dfa5d6a2b31a21ecfc5efe3

将这些文件下载到您的项目目录（例如，js/ 和 css/ 文件夹）后，在您的 HTML 文件的 <head> 或 <body> 底部引入它们：

<!-- 引入 jQuery 库 -->
<script src="path/to/jquery.min.js"></script>
<!-- 引入 jQuery UI JavaScript -->
<script src="path/to/jquery-ui.min.js"></script>
<!-- 引入 jQuery UI 样式表 -->
<link rel="stylesheet" href="path/to/jquery-ui.css" />

登录后复制

请将 path/to/ 替换为您实际的文件路径。

三、HTML 结构

我们将创建两个输入框，分别用于选择“开始日期”和“结束日期”。

<div class="col-lg-3 col-sm-12">
  <h4><b>开始日期 :</b></h4>
  <input type="text" class="form-control" name="f_date" id="datepicker1" required />
</div>
<div class="col-lg-3 col-sm-12">
  <h4><b>结束日期 :</b></h4>
  <input type="text" class="form-control" name="t_date" id="datepicker2" required/>
</div>

登录后复制

这里我们使用了 id="datepicker1" 和 id="datepicker2" 来标识这两个输入框，以便在 JavaScript 中进行初始化和操作。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

四、JavaScript 配置：实现月份和年份选择及日期联动

现在，我们将使用 jQuery UI Datepicker 对这两个输入框进行初始化，并添加只选择月份和年份的逻辑，以及日期范围的联动校验。

$(function() {
  // 初始化“开始日期”选择器
  $('#datepicker1').datepicker({
    changeMonth: true, // 允许选择月份
    changeYear: true,  // 允许选择年份
    showButtonPanel: true, // 显示按钮面板，包含“完成”按钮
    dateFormat: 'mm-yy', // 设置日期格式为“月-年”
    onClose: function(dateText, inst) {
      // 当日期选择器关闭时触发
      // 获取用户从下拉框中选择的月份和年份
      var month = $("#ui-datepicker-div .ui-datepicker-month :selected").val();
      var year = $("#ui-datepicker-div .ui-datepicker-year :selected").val();
      // 创建一个日期对象，设置为所选月份的第一天
      var selectedDate = new Date(year, month, 1);
      // 将输入框的值设置为所选的月份和年份
      $(this).datepicker('setDate', selectedDate);

      // 更新“结束日期”选择器的最小可选日期
      $('#datepicker2').datepicker('option', 'minDate', selectedDate);

      // 如果“结束日期”当前值早于“开始日期”，则重置“结束日期”为“开始日期”
      var toDate = $('#datepicker2').datepicker('getDate');
      if (toDate && toDate < selectedDate) {
        $('#datepicker2').datepicker('setDate', selectedDate);
      }
    }
  });

  // 初始化“结束日期”选择器
  $('#datepicker2').datepicker({
    changeMonth: true, // 允许选择月份
    changeYear: true,  // 允许选择年份
    showButtonPanel: true, // 显示按钮面板，包含“完成”按钮
    dateFormat: 'mm-yy', // 设置日期格式为“月-年”
    onClose: function(dateText, inst) {
      // 当日期选择器关闭时触发
      // 获取用户从下拉框中选择的月份和年份
      var month = $("#ui-datepicker-div .ui-datepicker-month :selected").val();
      var year = $("#ui-datepicker-div .ui-datepicker-year :selected").val();
      // 创建一个日期对象，设置为所选月份的第一天
      var selectedDate = new Date(year, month, 1);
      // 将输入框的值设置为所选的月份和年份
      $(this).datepicker('setDate', selectedDate);

      // 更新“开始日期”选择器的最大可选日期
      $('#datepicker1').datepicker('option', 'maxDate', selectedDate);

      // 如果“开始日期”当前值晚于“结束日期”，则重置“开始日期”为“结束日期”
      var fromDate = $('#datepicker1').datepicker('getDate');
      if (fromDate && fromDate > selectedDate) {
        $('#datepicker1').datepicker('setDate', selectedDate);
      }
    }
  });
});

登录后复制

代码解析：

$(function() { ... });: 这是 jQuery 的简写形式，确保在 DOM 加载完成后执行代码。
changeMonth: true, changeYear: true: 启用日期选择器顶部的月份和年份下拉菜单，允许用户直接选择。
showButtonPanel: true: 启用底部面板，当用户选择完月份和年份后，点击“完成”按钮即可关闭并设置日期。
dateFormat: 'mm-yy': 指定输入框中日期的显示格式为“月-年”。
onClose: function(dateText, inst) { ... }: 这是实现只选择月份和年份的关键。
- $("#ui-datepicker-div .ui-datepicker-month :selected").val() 和 $("#ui-datepicker-div .ui-datepicker-year :selected").val()：在 Datepicker 关闭时，我们直接从其内部生成的 HTML 元素中获取用户选择的月份和年份值。
- var selectedDate = new Date(year, month, 1);：创建一个新的 Date 对象，将其设置为所选月份的第一天。这是因为 jQuery UI Datepicker 内部仍然需要一个完整的日期对象。
- $(this).datepicker('setDate', selectedDate);：将输入框的日期设置为我们构造的 selectedDate。
日期范围联动 (minDate / maxDate 选项):
- 在 datepicker1 的 onClose 中，$('#datepicker2').datepicker('option', 'minDate', selectedDate); 将“结束日期”的最小可选日期设置为“开始日期”的所选日期。
- 在 datepicker2 的 onClose 中，$('#datepicker1').datepicker('option', 'maxDate', selectedDate); 将“开始日期”的最大可选日期设置为“结束日期”的所选日期。
- 额外的 if (toDate && toDate < selectedDate) / if (fromDate && fromDate > selectedDate) 逻辑用于确保在用户更改日期导致范围不合法时，自动调整另一个日期，保持日期范围的有效性。

五、CSS 样式：隐藏日历中的日期

为了确保用户界面只显示月份和年份选择器，我们需要添加一条简单的 CSS 规则来隐藏日历中的日期表格。

.ui-datepicker-calendar {
  display: none;
}

登录后复制

将这段 CSS 代码添加到您的样式表文件（例如 style.css）中，或者直接放在 HTML 文件的 <head> 标签内的 <style> 块中。

六、总结与注意事项

通过以上步骤，您已经成功实现了一个仅选择月份和年份的 jQuery UI Datepicker，并具备了“开始日期”和“结束日期”的联动校验功能。

注意事项：

库文件路径: 确保您引入的 jQuery、jQuery UI JavaScript 和 CSS 文件的路径是正确的。
版本兼容性: 本教程使用的 jQuery UI 版本是 1.13.2。不同版本之间可能存在细微的 API 差异，但核心概念通常保持一致。
用户体验: 尽管我们隐藏了日期部分，但 Datepicker 内部仍然处理完整的日期对象。onClose 事件中的逻辑确保了输入框最终显示的是用户期望的月份和年份。
国际化: 如果您的应用需要支持多种语言，可以查阅 jQuery UI Datepicker 的国际化选项 ($.datepicker.regional) 来配置月份名称、年份格式等。
替代方案: 除了 jQuery UI，还有其他日期选择器库（如 Bootstrap Datepicker、flatpickr 等）也提供了类似的功能，它们可能有不同的实现方式和配置选项。本教程专注于使用 jQuery UI。

以上就是使用 jQuery UI Datepicker 实现月份和年份选择教程的详细内容，更多请关注php中文网其它相关文章！